/usr/share/doc/racket/web-server-internal/url-param.html is in racket-doc 6.7-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 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"/><title>5.7 URL Param</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="../doc-site.css" title="default"/><script type="text/javascript" src="../scribble-common.js"></script><script type="text/javascript" src="../manual-racket.js"></script><script type="text/javascript" src="../doc-site.js"></script><script type="text/javascript" src="../local-redirect/local-redirect.js"></script><script type="text/javascript" src="../local-redirect/local-user-redirect.js"></script><!--[if IE 6]><style type="text/css">.SIEHidden { overflow: hidden; }</style><![endif]--></head><body id="doc-racket-lang-org"><div class="tocset"><div class="tocview"><div class="tocviewlist tocviewlisttopspace"><div class="tocviewtitle"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,"tocview_0");">►</a></td><td></td><td><a href="index.html" class="tocviewlink" data-pltdoc="x">Web Server:<span class="mywbr"> </span> HTTP Server</a></td></tr></table></div><div class="tocviewsublisttop" style="display: none;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1 </td><td><a href="dispatch-server-unit.html" class="tocviewlink" data-pltdoc="x">Dispatching Server</a></td></tr><tr><td align="right">2 </td><td><a href="dispatchers.html" class="tocviewlink" data-pltdoc="x">Dispatchers</a></td></tr><tr><td align="right">3 </td><td><a href="web-server.html" class="tocviewlink" data-pltdoc="x">Launching Servers</a></td></tr><tr><td align="right">4 </td><td><a href="Web_Servers.html" class="tocviewlink" data-pltdoc="x">Web Servers</a></td></tr><tr><td align="right">5 </td><td><a href="private.html" class="tocviewselflink" data-pltdoc="x">Internal APIs</a></td></tr><tr><td align="right">6 </td><td><a href="Troubleshooting_and_Tips.html" class="tocviewlink" data-pltdoc="x">Troubleshooting and Tips</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="tocviewlist"><table cellspacing="0" cellpadding="0"><tr><td style="width: 1em;"><a href="javascript:void(0);" title="Expand/Collapse" class="tocviewtoggle" onclick="TocviewToggle(this,"tocview_1");">▼</a></td><td>5 </td><td><a href="private.html" class="tocviewlink" data-pltdoc="x">Internal APIs</a></td></tr></table><div class="tocviewsublistbottom" style="display: block;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">5.1 </td><td><a href="timer.html" class="tocviewlink" data-pltdoc="x">Timers</a></td></tr><tr><td align="right">5.2 </td><td><a href="connection-manager.html" class="tocviewlink" data-pltdoc="x">Connection Manager</a></td></tr><tr><td align="right">5.3 </td><td><a href="closure.html" class="tocviewlink" data-pltdoc="x">Serializable Closures</a></td></tr><tr><td align="right">5.4 </td><td><a href="cache-table.html" class="tocviewlink" data-pltdoc="x">Cache Table</a></td></tr><tr><td align="right">5.5 </td><td><a href="mime-types.html" class="tocviewlink" data-pltdoc="x">MIME Types</a></td></tr><tr><td align="right">5.6 </td><td><a href="mod-map.html" class="tocviewlink" data-pltdoc="x">Serialization Utilities</a></td></tr><tr><td align="right">5.7 </td><td><a href="" class="tocviewselflink" data-pltdoc="x">URL Param</a></td></tr><tr><td align="right">5.8 </td><td><a href="gzip.html" class="tocviewlink" data-pltdoc="x">GZip</a></td></tr><tr><td align="right">5.9 </td><td><a href="misc-util.html" 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><a href="#%28def._%28%28lib._web-server%2Fprivate%2Furl-param..rkt%29._insert-param%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">insert-<wbr></wbr>param</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._web-server%2Fprivate%2Furl-param..rkt%29._extract-param%29%29" class="tocsublink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">extract-<wbr></wbr>param</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" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, "6.7", "../");" onfocus="this.style.color="black"; this.style.textAlign="left"; if (this.value == "...search manuals...") this.value="";" onblur="if (this.value.match(/^ *$/)) { this.style.color="#888"; this.style.textAlign="center"; this.value="...search manuals..."; }"/></form> <a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot("6.7");">top</a></span><span class="navright"> <a href="mod-map.html" title="backward to "5.6 Serialization Utilities"" data-pltdoc="x">← prev</a> <a href="private.html" title="up to "5 Internal APIs"" data-pltdoc="x">up</a> <a href="gzip.html" title="forward to "5.8 GZip"" data-pltdoc="x">next →</a></span> </div><h4 x-source-module="(lib "web-server/scribblings/web-server-internal.scrbl")" x-source-pkg="web-server-doc" x-part-tag=""url-param"">5.7<tt> </tt><a name="(part._url-param)"></a><a name="(mod-path._web-server/private/url-param)"></a>URL Param</h4><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left" colspan="2"><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=require.html%23%2528form._%2528%2528lib._racket%252Fprivate%252Fbase..rkt%2529._require%2529%2529&version=6.7" class="RktStxLink Sq" data-pltdoc="x">require</a></span><span class="stt"> </span><a href="" class="RktModLink" data-pltdoc="x"><span class="RktSym">web-server/private/url-param</span></a><span class="RktPn">)</span></td></tr><tr><td align="left"> </td><td align="right"><span class="RpackageSpec"><span class="Smaller"> package:</span> <span class="stt">web-server-lib</span></span></td></tr></table></div><div class="SIntrapara">The Web Server needs to encode information in URLs. If this data
is stored in the query string, than it will be overridden by browsers that
make GET requests to those URLs with more query data. So, it must be encoded
in URL params. This module provides functions for helping
with this process.</div><div class="SIntrapara"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._web-server/private/url-param..rkt)._insert-param))"></a><span title="Provided from: web-server/private/url-param | Package: web-server-lib"><span class="RktSym"><a href="#%28def._%28%28lib._web-server%2Fprivate%2Furl-param..rkt%29._insert-param%29%29" class="RktValDef RktValLink" data-pltdoc="x">insert-param</a></span></span><span class="hspace"> </span><span class="RktVar">u</span><span class="hspace"> </span><span class="RktVar">k</span><span class="hspace"> </span><span class="RktVar">v</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=net&rel=url.html%23%2528def._%2528%2528lib._net%252Furl-structs..rkt%2529._url%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">url?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">u</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=net&rel=url.html%23%2528def._%2528%2528lib._net%252Furl-structs..rkt%2529._url%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">url?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">k</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">v</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Associates <span class="RktVar">k</span> with <span class="RktVar">v</span> in the final URL param of <span class="RktVar">u</span>,
overwritting any current binding for <span class="RktVar">k</span>.</div></p></div><div class="SIntrapara"><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._web-server/private/url-param..rkt)._extract-param))"></a><span title="Provided from: web-server/private/url-param | Package: web-server-lib"><span class="RktSym"><a href="#%28def._%28%28lib._web-server%2Fprivate%2Furl-param..rkt%29._extract-param%29%29" class="RktValDef RktValLink" data-pltdoc="x">extract-param</a></span></span><span class="hspace"> </span><span class="RktVar">u</span><span class="hspace"> </span><span class="RktVar">k</span><span class="RktPn">)</span><span class="hspace"> </span>→<span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fbase..rkt%2529._or%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">or/c</a></span><span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">string?</a></span><span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._false%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">false/c</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">u</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=net&rel=url.html%23%2528def._%2528%2528lib._net%252Furl-structs..rkt%2529._url%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">url?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">k</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=strings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._string%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">string?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Extracts the string associated with <span class="RktVar">k</span> in the final URL param of
<span class="RktVar">u</span>, if there is one, returning <span class="RktVal">#f</span> otherwise.</div></p></div></p><div class="navsetbottom"><span class="navleft"><form class="searchform"><input class="searchbox" style="color: #888;" type="text" value="...search manuals..." title="Enter a search string to search the manuals" onkeypress="return DoSearchKey(event, this, "6.7", "../");" onfocus="this.style.color="black"; this.style.textAlign="left"; if (this.value == "...search manuals...") this.value="";" onblur="if (this.value.match(/^ *$/)) { this.style.color="#888"; this.style.textAlign="center"; this.value="...search manuals..."; }"/></form> <a href="../index.html" title="up to the documentation top" data-pltdoc="x" onclick="return GotoPLTRoot("6.7");">top</a></span><span class="navright"> <a href="mod-map.html" title="backward to "5.6 Serialization Utilities"" data-pltdoc="x">← prev</a> <a href="private.html" title="up to "5 Internal APIs"" data-pltdoc="x">up</a> <a href="gzip.html" title="forward to "5.8 GZip"" data-pltdoc="x">next →</a></span> </div></div></div><div id="contextindicator"> </div></body></html>
|