/usr/share/doc/racket/net/imap.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 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.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>10 IMAP: Reading Mail</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">Net:<span class="mywbr"> </span> Networking Libraries</a></td></tr></table></div><div class="tocviewsublisttop" style="display: block;" id="tocview_0"><table cellspacing="0" cellpadding="0"><tr><td align="right">1 </td><td><a href="http-client.html" class="tocviewlink" data-pltdoc="x">HTTP Client</a></td></tr><tr><td align="right">2 </td><td><a href="url.html" class="tocviewlink" data-pltdoc="x">URLs and HTTP</a></td></tr><tr><td align="right">3 </td><td><a href="uri-codec.html" class="tocviewlink" data-pltdoc="x">URI Codec:<span class="mywbr"> </span> Encoding and Decoding URIs</a></td></tr><tr><td align="right">4 </td><td><a href="ftp.html" class="tocviewlink" data-pltdoc="x">FTP:<span class="mywbr"> </span> Client</a></td></tr><tr><td align="right">5 </td><td><a href="sendurl.html" class="tocviewlink" data-pltdoc="x">Send URL:<span class="mywbr"> </span> Opening a Web Browser</a></td></tr><tr><td align="right">6 </td><td><a href="smtp.html" class="tocviewlink" data-pltdoc="x">SMTP:<span class="mywbr"> </span> Sending E-<wbr></wbr>Mail</a></td></tr><tr><td align="right">7 </td><td><a href="sendmail.html" class="tocviewlink" data-pltdoc="x"><span class="stt">sendmail</span>:<span class="mywbr"> </span> Sending E-<wbr></wbr>Mail</a></td></tr><tr><td align="right">8 </td><td><a href="head.html" class="tocviewlink" data-pltdoc="x">Headers:<span class="mywbr"> </span> Parsing and Constructing</a></td></tr><tr><td align="right">9 </td><td><a href="unihead.html" class="tocviewlink" data-pltdoc="x">Header Field Encoding</a></td></tr><tr><td align="right">10 </td><td><a href="" class="tocviewselflink" data-pltdoc="x">IMAP:<span class="mywbr"> </span> Reading Mail</a></td></tr><tr><td align="right">11 </td><td><a href="pop3.html" class="tocviewlink" data-pltdoc="x">POP3:<span class="mywbr"> </span> Reading Mail</a></td></tr><tr><td align="right">12 </td><td><a href="mime.html" class="tocviewlink" data-pltdoc="x">MIME:<span class="mywbr"> </span> Decoding Internet Data</a></td></tr><tr><td align="right">13 </td><td><a href="base64.html" class="tocviewlink" data-pltdoc="x">Base 64:<span class="mywbr"> </span> Encoding and Decoding</a></td></tr><tr><td align="right">14 </td><td><a href="qp.html" class="tocviewlink" data-pltdoc="x">Quoted-<wbr></wbr>Printable:<span class="mywbr"> </span> Encoding and Decoding</a></td></tr><tr><td align="right">15 </td><td><a href="dns.html" class="tocviewlink" data-pltdoc="x">DNS:<span class="mywbr"> </span> Domain Name Service Queries</a></td></tr><tr><td align="right">16 </td><td><a href="nntp.html" class="tocviewlink" data-pltdoc="x">NNTP:<span class="mywbr"> </span> Newsgroup Protocol</a></td></tr><tr><td align="right">17 </td><td><a href="tcp.html" class="tocviewlink" data-pltdoc="x">TCP:<span class="mywbr"> </span> Unit and Signature</a></td></tr><tr><td align="right">18 </td><td><a href="tcp-redirect.html" class="tocviewlink" data-pltdoc="x">TCP Redirect:<span class="mywbr"> </span> <span class="RktSym"><span class="RktStxLink">tcp^</span></span> via Channels</a></td></tr><tr><td align="right">19 </td><td><a href="ssl-tcp-unit.html" class="tocviewlink" data-pltdoc="x">SSL Unit:<span class="mywbr"> </span> <span class="RktSym"><span class="RktStxLink">tcp^</span></span> via SSL</a></td></tr><tr><td align="right">20 </td><td><a href="cgi.html" class="tocviewlink" data-pltdoc="x">CGI Scripts</a></td></tr><tr><td align="right">21 </td><td><a href="cookie.html" class="tocviewlink" data-pltdoc="x">Cookie:<span class="mywbr"> </span> Legacy HTTP Client Storage</a></td></tr><tr><td align="right">22 </td><td><a href="git-checkout.html" class="tocviewlink" data-pltdoc="x">Git Repository Checkout</a></td></tr><tr><td align="right"></td><td><a href="doc-bibliography.html" class="tocviewlink" data-pltdoc="x">Bibliography</a></td></tr><tr><td align="right"></td><td><a href="doc-index.html" class="tocviewlink" data-pltdoc="x">Index</a></td></tr></table></div></div><div class="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>10 </td><td><a href="" class="tocviewselflink" data-pltdoc="x">IMAP:<span class="mywbr"> </span> Reading Mail</a></td></tr></table><div class="tocviewsublistbottom" style="display: none;" id="tocview_1"><table cellspacing="0" cellpadding="0"><tr><td align="right">10.1 </td><td><a href="#%28part._.Connecting_and_.Selecting_.Mailboxes%29" class="tocviewlink" data-pltdoc="x">Connecting and Selecting Mailboxes</a></td></tr><tr><td align="right">10.2 </td><td><a href="#%28part._.Selected_.Mailbox_.State%29" class="tocviewlink" data-pltdoc="x">Selected Mailbox State</a></td></tr><tr><td align="right">10.3 </td><td><a href="#%28part._.Manipulating_.Messages%29" class="tocviewlink" data-pltdoc="x">Manipulating Messages</a></td></tr><tr><td align="right">10.4 </td><td><a href="#%28part._.Querying_and_.Changing__.Other__.Mailboxes%29" class="tocviewlink" data-pltdoc="x">Querying and Changing (Other) Mailboxes</a></td></tr><tr><td align="right">10.5 </td><td><a href="#%28part._.I.M.A.P_.Unit%29" class="tocviewlink" data-pltdoc="x">IMAP Unit</a></td></tr><tr><td align="right">10.6 </td><td><a href="#%28part._.I.M.A.P_.Signature%29" class="tocviewlink" data-pltdoc="x">IMAP Signature</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.1<tt> </tt></span><a href="#%28part._.Connecting_and_.Selecting_.Mailboxes%29" class="tocsubseclink" data-pltdoc="x">Connecting and Selecting Mailboxes</a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>connection?</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>connect</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-port-number%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>port-<wbr></wbr>number</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connect%2A%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>connect*</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-disconnect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>disconnect</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-force-disconnect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>force-<wbr></wbr>disconnect</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reselect%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>reselect</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-examine%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>examine</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.2<tt> </tt></span><a href="#%28part._.Selected_.Mailbox_.State%29" class="tocsubseclink" data-pltdoc="x">Selected Mailbox State</a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-noop%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>noop</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-poll%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>poll</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-messages%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>messages</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-recent%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>recent</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-unseen%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>unseen</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-uidnext%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>uidnext</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-uidvalidity%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>uidvalidity</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-new~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>new?</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reset-new%21%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>reset-<wbr></wbr>new!</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-expunges%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>get-<wbr></wbr>expunges</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-pending-expunges~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>pending-<wbr></wbr>expunges?</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-updates%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>get-<wbr></wbr>updates</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-pending-updates~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>pending-<wbr></wbr>updates?</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.3<tt> </tt></span><a href="#%28part._.Manipulating_.Messages%29" class="tocsubseclink" data-pltdoc="x">Manipulating Messages</a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-messages%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>get-<wbr></wbr>messages</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-flag-~3esymbol%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>flag-<wbr></wbr>>symbol</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._symbol-~3eimap-flag%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">symbol-<wbr></wbr>>imap-<wbr></wbr>flag</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-store%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>store</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-expunge%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>expunge</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.4<tt> </tt></span><a href="#%28part._.Querying_and_.Changing__.Other__.Mailboxes%29" class="tocsubseclink" data-pltdoc="x">Querying and Changing (Other) Mailboxes</a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-copy%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>copy</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-append%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>append</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-status%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>status</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-mailbox-exists~3f%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>mailbox-<wbr></wbr>exists?</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-create-mailbox%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>create-<wbr></wbr>mailbox</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-list-child-mailboxes%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>list-<wbr></wbr>child-<wbr></wbr>mailboxes</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-hierarchy-delimiter%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>get-<wbr></wbr>hierarchy-<wbr></wbr>delimiter</span></span></a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-mailbox-flags%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap-<wbr></wbr>mailbox-<wbr></wbr>flags</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.5<tt> </tt></span><a href="#%28part._.I.M.A.P_.Unit%29" class="tocsubseclink" data-pltdoc="x">IMAP Unit</a></td></tr><tr><td><a href="#%28def._%28%28lib._net%2Fimap-unit..rkt%29._imap~40%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktValLink">imap@</span></span></a></td></tr><tr><td><span class="tocsublinknumber">10.6<tt> </tt></span><a href="#%28part._.I.M.A.P_.Signature%29" class="tocsubseclink" data-pltdoc="x">IMAP Signature</a></td></tr><tr><td><a href="#%28form._%28%28lib._net%2Fimap-sig..rkt%29._imap~5e%29%29" class="tocsubnonseclink" data-pltdoc="x"><span class="RktSym"><span class="RktStxLink">imap^</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="unihead.html" title="backward to "9 Header Field Encoding"" data-pltdoc="x">← prev</a> <a href="index.html" title="up to "Net: Networking Libraries"" data-pltdoc="x">up</a> <a href="pop3.html" title="forward to "11 POP3: Reading Mail"" data-pltdoc="x">next →</a></span> </div><h3 x-source-module="(lib "net/scribblings/net.scrbl")" x-source-pkg="net-doc" x-part-tag=""imap"">10<tt> </tt><a name="(part._imap)"></a><a name="(mod-path._net/imap)"></a>IMAP: Reading Mail</h3><p><div class="SIntrapara"><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><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">net/imap</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller"> package:</span> <span class="stt">net-lib</span></span></td></tr></table></div><div class="SIntrapara">The <a href="" class="RktModLink" data-pltdoc="x"><span class="RktSym">net/imap</span></a> module provides
utilities for the client side of Internet Message Access Protocol
version 4rev1 [<a href="doc-bibliography.html#%28cite._.R.F.C2060%29" data-pltdoc="x">RFC2060</a>].</div></p><h4 x-source-module="(lib "net/scribblings/net.scrbl")" x-source-pkg="net-doc" x-part-tag=""Connecting_and_Selecting_Mailboxes"">10.1<tt> </tt><a name="(part._.Connecting_and_.Selecting_.Mailboxes)"></a>Connecting and Selecting Mailboxes</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._net/imap..rkt)._imap-connection~3f))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-connection?</a></span></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=reference&rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span></p></blockquote></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=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.7" class="RktValLink Sq" 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 IMAP-connection value (which is
opaque), <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._net/imap..rkt)._imap-connect))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connect%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-connect</a></span></span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">server</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">username</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">password</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">mailbox</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span>[</td><td valign="top"><span class="RktPn">#:tls?</span><span class="hspace"> </span><span class="RktVar">tls?</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktPn">#:try-tls?</span><span class="hspace"> </span><span class="RktVar">try-tls?</span>]<span class="RktPn">)</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">→</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">server</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">username</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">password</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">tls?</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=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace"> </span>=<span class="hspace"> </span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">try-tls?</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=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace"> </span>=<span class="hspace"> </span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Establishes an IMAP connection to the given server using the given
username and password, and selects the specified mailbox. If
<span class="RktVar">tls?</span> is true, a TLS connection is made to the server before
communicating using the IMAP protocol. If <span class="RktVar">tls?</span> is <span class="RktVal">#f</span>
but <span class="RktVar">try-tls?</span> is true, then after the IMAP connection is
initially established, the connection is switched to a TLS connection
if the server supports it.</div></p><p>The first result value represents the connection.
The second and third return values indicate the total number of
messages in the mailbox and the number of recent messages (i.e.,
messages received since the mailbox was last selected), respectively.</p><p>See also <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-port-number%29%29" class="RktValLink" data-pltdoc="x">imap-port-number</a></span>.</p><p>A user’s primary mailbox is always called
<span class="RktVal">"INBOX"</span>. (Capitalization doesn’t matter for that mailbox
name.)</p><p>Updated message-count and recent-count values are available through
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-messages%29%29" class="RktValLink" data-pltdoc="x">imap-messages</a></span> and <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-recent%29%29" class="RktValLink" data-pltdoc="x">imap-recent</a></span>. See also <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-new~3f%29%29" class="RktValLink" data-pltdoc="x">imap-new?</a></span> and
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reset-new%21%29%29" class="RktValLink" data-pltdoc="x">imap-reset-new!</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._net/imap..rkt)._imap-port-number))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-port-number%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-port-number</a></span></span><span class="RktPn"></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._integer-in%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">integer-in</a></span><span class="hspace"> </span><span class="RktVal">0</span><span class="hspace"> </span><span class="RktVal">65535</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="RktPn">(</span><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-port-number%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-port-number</a></span></span><span class="hspace"> </span><span class="RktVar">k</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</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="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._integer-in%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">integer-in</a></span><span class="hspace"> </span><span class="RktVal">0</span><span class="hspace"> </span><span class="RktVal">65535</span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">A parameter that determines the server port number. The initial value
is <span class="RktVal">143</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._net/imap..rkt)._imap-connect*))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connect%2A%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-connect*</a></span></span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">in</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">out</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">username</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">password</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">mailbox</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span>[</td><td valign="top"><span class="RktPn">#:tls?</span><span class="hspace"> </span><span class="RktVar">tls?</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktPn">#:try-tls?</span><span class="hspace"> </span><span class="RktVar">try-tls?</span>]<span class="RktPn">)</span></td><td valign="top"><span class="hspace"> </span></td></tr></table></blockquote></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="prototype"><tr><td valign="top"><span class="hspace"> </span></td><td valign="top">→</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr></table></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">in</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=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._input-port%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">input-port?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">out</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=port-ops.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._output-port%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">output-port?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">username</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">password</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">tls?</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=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace"> </span>=<span class="hspace"> </span><span class="RktVal">#f</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">try-tls?</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=data-structure-contracts.html%23%2528def._%2528%2528lib._racket%252Fcontract%252Fprivate%252Fmisc..rkt%2529._any%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">any/c</a></span><span class="hspace"> </span>=<span class="hspace"> </span><span class="RktVal">#t</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connect%29%29" class="RktValLink" data-pltdoc="x">imap-connect</a></span>, but given input and output ports (e.g.,
ports for an SSL session) instead of a server address.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-disconnect))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-disconnect%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-disconnect</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Closes an IMAP connection. The close may fail due to a communication
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._net/imap..rkt)._imap-force-disconnect))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-force-disconnect%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-force-disconnect</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Closes an IMAP connection forcefully (i.e., without send a close
message to the server). A forced disconnect never 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._((lib._net/imap..rkt)._imap-reselect))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reselect%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-reselect</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mailbox</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">→</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">De-selects the mailbox currently selected by the connection and
selects the specified mailbox, returning the total and recent message
counts for the new mailbox. Expunge and message-state information is
removed.</div></p><p>Do not use this procedure to poll a mailbox to see whether there are
any new messages. Use <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-noop%29%29" class="RktValLink" data-pltdoc="x">imap-noop</a></span>, <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-new~3f%29%29" class="RktValLink" data-pltdoc="x">imap-new?</a></span>, and
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reset-new%21%29%29" class="RktValLink" data-pltdoc="x">imap-reset-new!</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><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-examine))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-examine%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-examine</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mailbox</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">→</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Like <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reselect%29%29" class="RktValLink" data-pltdoc="x">imap-reselect</a></span>, but the mailbox is selected as read-only.</div></p><h4 x-source-module="(lib "net/scribblings/net.scrbl")" x-source-pkg="net-doc" x-part-tag=""Selected_Mailbox_State"">10.2<tt> </tt><a name="(part._.Selected_.Mailbox_.State)"></a>Selected Mailbox State</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._net/imap..rkt)._imap-noop))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-noop%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-noop</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="RktPn">)</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">→</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0"><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><span class="RktSym"><a href="https://download.racket-lang.org/docs/6.7/html/local-redirect/index.html?doc=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr></table></td></tr></table></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Sends a “no-op” message to the server, typically to keep the session
alive. As for many commands, the server may report message-state
updates or expunges, which are recorded in <span class="RktVar">imap</span>.</div></p><p>The return information is the same as for <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reselect%29%29" class="RktValLink" data-pltdoc="x">imap-reselect</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._net/imap..rkt)._imap-poll))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-poll%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-poll</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Does not send a request to the server, but checks for asynchronous
messages from the server that update the message count, to report
expunges, etc.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-messages))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-messages%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-messages</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of messages in the selected mailbox. The server can
update this count during most any interaction.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-recent))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-recent%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-recent</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of “recent” messages in the currently selected
mailbox, as most recently reported by the server. The server can
update this count during most any interaction.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-unseen))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-unseen%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-unseen</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace"> </span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the number of “unseen” messages in the currently selected
mailbox, as most recently reported by the server. The server can
update this count during most any interaction. Old IMAP servers might
not report this value, in which case the result is <span class="RktVal">#f</span>.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-uidnext))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-uidnext%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-uidnext</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace"> </span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the predicted next uid for a message in the currently selected
mailbox, as most recently reported by the server. The server can
update this count during most any interaction. Old IMAP servers might
not report this value, in which case the result is <span class="RktVal">#f</span>.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-uidvalidity))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-uidvalidity%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-uidvalidity</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="hspace"> </span><span class="RktVal">#f</span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns an id number that changes when all uids become invalid. The
server <span style="font-style: italic">cannot</span> update this number during a session. Old IMAP
servers might not report this value, in which case the result is
<span class="RktVal">#f</span>.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-new~3f))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-new~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-new?</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if the server has reported an increase in the
message count for the currently mailbox since the last call to
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reset-new%21%29%29" class="RktValLink" data-pltdoc="x">imap-reset-new!</a></span>. Selecting a mailbox implicitly calls
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reset-new%21%29%29" class="RktValLink" data-pltdoc="x">imap-reset-new!</a></span>.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-reset-new!))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reset-new%21%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-reset-new!</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Resets the new flag for the session; see <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-new~3f%29%29" class="RktValLink" data-pltdoc="x">imap-new?</a></span>.
This operation does not communicate with the server.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-get-expunges))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-expunges%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-get-expunges</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns pending expunge notifications from the server for the selected
mailbox in terms of message positions (not uids), and clears the
pending notifications. The result list is sorted, ascending.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication.</p><p>The server can notify the client of newly deleted messages during most
other commands, but not asynchronously between commands. Furthermore,
the server cannot report new deletions during <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-messages%29%29" class="RktValLink" data-pltdoc="x">imap-get-messages</a></span> or
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-store%29%29" class="RktValLink" data-pltdoc="x">imap-store</a></span> operations.</p><p>Before calling any IMAP operation that works in terms of message
numbers, pending expunge notifications must be handled by calling
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-expunges%29%29" class="RktValLink" data-pltdoc="x">imap-get-expunges</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._net/imap..rkt)._imap-pending-expunges~3f))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-pending-expunges~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-pending-expunges?</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#f</span> if <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-expunges%29%29" class="RktValLink" data-pltdoc="x">imap-get-expunges</a></span> would return an
empty list, <span class="RktVal">#t</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._net/imap..rkt)._imap-get-updates))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-updates%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-get-updates</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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"> </span></td><td valign="top">→</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</a></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._cons%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">cons/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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span></td></tr><tr><td><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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._pair%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">pair?</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"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns information must like <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-messages%29%29" class="RktValLink" data-pltdoc="x">imap-get-messages</a></span>, but includes
information reported asynchronously by the server (e.g., to notify a
client with some other client changes a message attribute). Instead
of reporting specific requested information for specific messages, the
result is associates message positions to field-value association
lists. The result list is sorted by message position, ascending.</div></p><p>This operation does not communicate with the server. It merely reports
the result of previous communication. It also clears the update information from the
connection after reporting it.</p><p>When a server reports information that supersedes old reported
information for a message, or if the server reports that a message has
been deleted, then old information for the message is
dropped. Similarly, if <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-messages%29%29" class="RktValLink" data-pltdoc="x">imap-get-messages</a></span> is used to
explicitly obtain information, any redundant (or out-of-date)
information is dropped.</p><p>A client need not use <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-updates%29%29" class="RktValLink" data-pltdoc="x">imap-get-updates</a></span> ever, but accumulated
information for the connection consumes space.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-pending-updates~3f))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-pending-updates~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-pending-updates?</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#f</span> if <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-updates%29%29" class="RktValLink" data-pltdoc="x">imap-get-updates</a></span> would return an
list, <span class="RktVal">#t</span> otherwise.</div></p><h4 x-source-module="(lib "net/scribblings/net.scrbl")" x-source-pkg="net-doc" x-part-tag=""Manipulating_Messages"">10.3<tt> </tt><a name="(part._.Manipulating_.Messages)"></a>Manipulating Messages</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._net/imap..rkt)._imap-get-messages))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-messages%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-get-messages</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">msg-nums</span><span class="hspace"> </span><span class="RktVar">fields</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">list?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">msg-nums</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="argcontract"><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">fields</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">:</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</a></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="RktVal">'</span><span class="RktVal">uid</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">header</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">body</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">flags</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Downloads information for a set of messages. The <span class="RktVar">msg-nums</span>
argument specifies a set of messages by their message positions (not
their uids). The <span class="RktVar">fields</span> argument specifies the type of
information to download for each message. The available fields are:</div></p><ul><li><p><span class="RktVal">'</span><span class="RktVal">uid</span> —<wbr></wbr> the value is an integer</p></li><li><p><span class="RktVal">'</span><span class="RktVal">header</span> —<wbr></wbr> the value is a header (a string, but see
<a href="head.html" class="RktModLink" data-pltdoc="x"><span class="RktSym">net/head</span></a>)</p></li><li><p><span class="RktVal">'</span><span class="RktVal">body</span> —<wbr></wbr> the value is a byte string, with
CRLF-separated lines</p></li><li><p><span class="RktVal">'</span><span class="RktVal">flags</span> —<wbr></wbr> the value is a list of symbols that
correspond to IMAP flags; see <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-flag-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">imap-flag->symbol</a></span></p></li></ul><p>The return value is a list of entry items in parallel to
<span class="RktVar">msg-nums</span>. Each entry is itself a list containing value items
in parallel to <span class="RktVar">fields</span>.</p><p>Pending expunges must be handled before calling this function; see
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-expunges%29%29" class="RktValLink" data-pltdoc="x">imap-get-expunges</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">> </span><span class="RktPn">(</span><span class="RktSym">imap-get-message</span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace"> </span><span class="RktVal">3</span><span class="hspace"> </span><span class="RktVal">5</span><span class="RktVal">)</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">uid</span><span class="hspace"> </span><span class="RktVal">header</span><span class="RktVal">)</span><span class="RktPn">)</span></td></tr><tr><td><table cellspacing="0" cellpadding="0"><tr><td><p><span class="RktRes">'((107 #"From: larry@stooges.com ...")</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace"> </span><span class="RktRes">(110 #"From: moe@stooges.com ...")</span></p></td></tr><tr><td><p><span class="RktRes"></span><span class="hspace"> </span><span class="RktRes">(112 #"From: curly@stooges.com ..."))</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._net/imap..rkt)._imap-flag-~3esymbol))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-flag-~3esymbol%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-flag->symbol</a></span></span><span class="hspace"> </span><span class="RktVar">flag</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=reference&rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">flag</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=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span></td></tr></table></td></tr><tr><td><table cellspacing="0" cellpadding="0" class="together"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._symbol-~3eimap-flag))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._symbol-~3eimap-flag%29%29" class="RktValDef RktValLink" data-pltdoc="x">symbol->imap-flag</a></span></span><span class="hspace"> </span><span class="RktVar">sym</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=reference&rel=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">sym</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=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">An IMAP flag is a symbol, but it is generally not a convenient one to
use within a Racket program, because it usually starts with a
backslash. The <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-flag-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">imap-flag->symbol</a></span> and
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._symbol-~3eimap-flag%29%29" class="RktValLink" data-pltdoc="x">symbol->imap-flag</a></span> procedures convert IMAP flags to convenient
symbols and vice-versa:</div></p><p><table cellspacing="0" cellpadding="0"><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span style="font-style: italic">symbol</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span style="font-style: italic">IMAP flag</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p>message flags:</p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">seen</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Seen|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">answered</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Answered|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">flagged</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Flagged|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">deleted</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Deleted|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">draft</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Draft|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">recent</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Recent|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p>mailbox flags:</p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">noinferiors</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Noinferiors|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">noselect</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Noselect|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">marked</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Marked|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">unmarked</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\Unmarked|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">hasnochildren</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\HasNoChildren|</span></p></td></tr><tr><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">haschildren</span></p></td><td><p><span class="hspace"> </span></p></td><td><p><span class="RktVal">'</span><span class="RktVal">|\HasChildren|</span></p></td></tr></table></p><p>The <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-flag-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">imap-flag->symbol</a></span> and <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._symbol-~3eimap-flag%29%29" class="RktValLink" data-pltdoc="x">symbol->imap-flag</a></span>
functions act like the identity function when any other symbol is
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._net/imap..rkt)._imap-store))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-store%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-store</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mode</span><span class="hspace"> </span><span class="RktVar">msg-nums</span><span class="hspace"> </span><span class="RktVar">imap-flags</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mode</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="RktVal">'</span><span class="RktVal">+</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal"><span class="nobreak">-</span></span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">!</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">msg-nums</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap-flags</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Sets flags for a set of messages. The mode argument specifies how
flags are set:</div></p><ul><li><p><span class="RktVal">'</span><span class="RktVal">+</span> —<wbr></wbr> add the given flags to each message</p></li><li><p><span class="RktVal">'</span><span class="RktVal"><span class="nobreak">-</span></span> —<wbr></wbr> remove the given flags from each message</p></li><li><p><span class="RktVal">'</span><span class="RktVal">!</span> —<wbr></wbr> set each message’s flags to the given set</p></li></ul><p>The <span class="RktVar">msg-nums</span> argument specifies a set of messages by their
message positions (not their uids). The <span class="RktSym">flags</span> argument
specifies the imap flags to add/remove/install.</p><p>Pending expunges must be handled before calling this function; see
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-expunges%29%29" class="RktValLink" data-pltdoc="x">imap-get-expunges</a></span>. The server will not report back
message-state changes (so they will not show up through
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-updates%29%29" class="RktValLink" data-pltdoc="x">imap-get-updates</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">> </span><span class="RktPn">(</span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-store%29%29" class="RktValLink" data-pltdoc="x">imap-store</a></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">+</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">1</span><span class="hspace"> </span><span class="RktVal">2</span><span class="hspace"> </span><span class="RktVal">3</span><span class="RktVal">)</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=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">list</a></span><span class="hspace"> </span><span class="RktPn">(</span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._symbol-~3eimap-flag%29%29" class="RktValLink" data-pltdoc="x">symbol->imap-flag</a></span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">deleted</span><span class="RktPn">)</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt"> </span><span class="RktCmt">marks the first three messages to be deleted</span></td></tr><tr><td><span class="stt">> </span><span class="RktPn">(</span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-expunge%29%29" class="RktValLink" data-pltdoc="x">imap-expunge</a></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="RktPn">)</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt"> </span><span class="RktCmt">permanently removes the first three messages (and possibly</span></td></tr><tr><td><span class="RktCmt">;</span><span class="RktCmt"> </span><span class="RktCmt">others) from the currently-selected mailbox</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._net/imap..rkt)._imap-expunge))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-expunge%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-expunge</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Purges every message currently marked with the <span class="RktVal">'</span><span class="RktVal">|\Deleted|</span>
flag from the mailbox.</div></p><h4 x-source-module="(lib "net/scribblings/net.scrbl")" x-source-pkg="net-doc" x-part-tag=""Querying_and_Changing__Other__Mailboxes"">10.4<tt> </tt><a name="(part._.Querying_and_.Changing__.Other__.Mailboxes)"></a>Querying and Changing (Other) Mailboxes</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._net/imap..rkt)._imap-copy))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-copy%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-copy</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">msg-nums</span><span class="hspace"> </span><span class="RktVar">dest-mailbox</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">msg-nums</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=number-types.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._exact-nonnegative-integer%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">exact-nonnegative-integer?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">dest-mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Copies the specified messages from the currently selected mailbox to
the specified mailbox.</div></p><p>Pending expunges must be handled before calling this function; see
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-expunges%29%29" class="RktValLink" data-pltdoc="x">imap-get-expunges</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._net/imap..rkt)._imap-append))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-append%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-append</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mailbox</span><span class="hspace"> </span><span class="RktVar">message</span><span class="hspace"> </span>[<span class="RktVar">flags</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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">message</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" 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"> </span></td><td valign="top"><span class="RktVar">flags</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">:</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><table cellspacing="0" cellpadding="0" class="RktBlk"><tr><td><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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</a></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="RktVal">'</span><span class="RktVal">seen</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">answered</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">flagged</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">deleted</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">draft</span><span class="hspace"> </span><span class="RktVal">'</span><span class="RktVal">recent</span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr></table></td><td valign="top"><span class="hspace"> </span></td><td valign="top">=</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVal">'</span><span class="RktVal">(</span><span class="RktVal">seen</span><span class="RktVal">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Adds a new message (containing <span class="RktVar">message</span>) to the given
mailbox.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-status))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-status%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-status</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mailbox</span><span class="hspace"> </span><span class="RktVar">statuses</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=reference&rel=pairs.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._list%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">list?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">statuses</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Requests information about a mailbox from the server, typically
<span style="font-style: italic">not</span> the currently selected mailbox.</div></p><p>The <span class="RktVar">statuses</span> list specifies the request, and the return value
includes one value for each symbol in <span class="RktVar">statuses</span>. The allowed
status symbols are:</p><ul><li><p><span class="RktVal">'</span><span class="RktVal">messages</span> —<wbr></wbr> number of messages</p></li><li><p><span class="RktVal">'</span><span class="RktVal">recent</span> —<wbr></wbr> number of recent messages</p></li><li><p><span class="RktVal">'</span><span class="RktVal">unseen</span> —<wbr></wbr> number of unseen messages</p></li><li><p><span class="RktVal">'</span><span class="RktVal">uidnext</span> —<wbr></wbr> uid for next received message</p></li><li><p><span class="RktVal">'</span><span class="RktVal">uidvalidity</span> —<wbr></wbr> id that changes when all uids are changed</p></li></ul><p>Use <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-messages%29%29" class="RktValLink" data-pltdoc="x">imap-messages</a></span> to get the message count for the currently
selected mailbox, etc. Use <span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-new~3f%29%29" class="RktValLink" data-pltdoc="x">imap-new?</a></span> and
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-reset-new%21%29%29" class="RktValLink" data-pltdoc="x">imap-reset-new!</a></span> to detect when new messages are available in
the currently selected mailbox.</p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-mailbox-exists~3f))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-mailbox-exists~3f%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-mailbox-exists?</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mailbox</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=reference&rel=booleans.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._boolean%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">boolean?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns <span class="RktVal">#t</span> if <span class="RktVar">mailbox</span> exists, <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._net/imap..rkt)._imap-create-mailbox))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-create-mailbox%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-create-mailbox</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mailbox</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=reference&rel=void.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._void%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">void?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Creates <span class="RktVar">mailbox</span>. (It must not exist 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><table cellspacing="0" cellpadding="0" class="prototype RForeground"><tr><td valign="top"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-list-child-mailboxes))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-list-child-mailboxes%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-list-child-mailboxes</a></span></span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">imap</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktVar">mailbox</span></td><td valign="top"><span class="hspace"> </span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span>[</td><td valign="top"><span class="RktVar">delimiter</span>]<span class="RktPn">)</span></td><td valign="top"><span class="hspace"> </span></td></tr></table></blockquote></td></tr><tr><td><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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</a></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._list%252Fc%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">list/c</a></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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span><span class="RktPn">)</span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="hspace"> </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"> </span></td><td valign="top"><span class="RktVar">delimiter</span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">:</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr><tr><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="hspace"> </span></td><td valign="top">=</td><td valign="top"><span class="hspace"> </span></td><td valign="top"><span class="RktPn">(</span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-hierarchy-delimiter%29%29" class="RktValLink" data-pltdoc="x">imap-get-hierarchy-delimiter</a></span><span class="RktPn">)</span></td></tr></table></td></tr></table></blockquote></div><div class="SIntrapara">Returns information about sub-mailboxes of <span class="RktVar">mailbox</span>; if
<span class="RktVar">mailbox</span> is <span class="RktVal">#f</span>, information about all top-level
mailboxes is returned. The <span class="RktVar">delimiter</span> is used to parse mailbox
names from the server to detect hierarchy.</div></p><p>The return value is a list of mailbox-information lists. Each
mailbox-information list contains two items:</p><ul><li><p>a list of imap flags for the mailbox</p></li><li><p>the mailbox’s name</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._net/imap..rkt)._imap-get-hierarchy-delimiter))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-get-hierarchy-delimiter%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-get-hierarchy-delimiter</a></span></span><span class="hspace"> </span><span class="RktVar">imap</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=reference&rel=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr></table></blockquote></div><div class="SIntrapara">Returns the server-specific string that is used as a separator in
mailbox path names.</div></p><p><div class="SIntrapara"><blockquote class="SVInsetFlow"><table cellspacing="0" cellpadding="0" class="boxed RBoxed"><tr><td><blockquote class="SubFlow"><div class="RBackgroundLabel SIEHidden"><div class="RBackgroundLabelInner"><p>procedure</p></div></div><p class="RForeground"><span class="RktPn">(</span><a name="(def._((lib._net/imap..rkt)._imap-mailbox-flags))"></a><span title="Provided from: net/imap | Package: net-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-mailbox-flags%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap-mailbox-flags</a></span></span><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span><span class="RktVar">mailbox</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._listof%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">listof</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=symbols.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._symbol%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">symbol?</a></span><span class="RktPn">)</span></p></blockquote></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">imap</span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-connection~3f%29%29" class="RktValLink" data-pltdoc="x">imap-connection?</a></span></td></tr><tr><td><span class="hspace"> </span><span class="RktVar">mailbox</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=bytestrings.html%23%2528def._%2528%2528quote._%7E23%7E25kernel%2529._bytes%7E3f%2529%2529&version=6.7" class="RktValLink Sq" data-pltdoc="x">bytes?</a></span><span class="RktPn">)</span></td></tr></table></blockquote></div><div class="SIntrapara">Returns a list of IMAP flags for the given mailbox. See also
<span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap..rkt%29._imap-flag-~3esymbol%29%29" class="RktValLink" data-pltdoc="x">imap-flag->symbol</a></span>.</div></p><h4 x-source-module="(lib "net/scribblings/net.scrbl")" x-source-pkg="net-doc" x-part-tag=""IMAP_Unit"">10.5<tt> </tt><a name="(part._.I.M.A.P_.Unit)"></a><a name="(mod-path._net/imap-unit)"></a>IMAP Unit</h4><blockquote class="refpara"><blockquote class="refcolumn"><blockquote class="refcontent"><p><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap-unit..rkt%29._imap~40%29%29" class="RktValLink" data-pltdoc="x">imap@</a></span> and <span class="RktSym"><a href="#%28form._%28%28lib._net%2Fimap-sig..rkt%29._imap~5e%29%29" class="RktStxLink" data-pltdoc="x">imap^</a></span> are deprecated.
They exist for backward-compatibility and will likely be removed in
the future. New code should use the <a href="" class="RktModLink" data-pltdoc="x"><span class="RktSym">net/imap</span></a> module.</p></blockquote></blockquote></blockquote><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><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="#%28mod-path._net%2Fimap-unit%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">net/imap-unit</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller"> package:</span> <span class="stt">compatibility-lib</span></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>value</p></div></div><p class="RForeground"><a name="(def._((lib._net/imap-unit..rkt)._imap~40))"></a><span title="Provided from: net/imap-unit | Package: compatibility-lib"><span class="RktSym"><a href="#%28def._%28%28lib._net%2Fimap-unit..rkt%29._imap~40%29%29" class="RktValDef RktValLink" data-pltdoc="x">imap@</a></span></span><span class="hspace"> </span>:<span class="hspace"> </span><span class="RktSym">unit?</span></p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara">Imports nothing, exports <span class="RktSym"><a href="#%28form._%28%28lib._net%2Fimap-sig..rkt%29._imap~5e%29%29" class="RktStxLink" data-pltdoc="x">imap^</a></span>.</div></p><h4 x-source-module="(lib "net/scribblings/net.scrbl")" x-source-pkg="net-doc" x-part-tag=""IMAP_Signature"">10.6<tt> </tt><a name="(part._.I.M.A.P_.Signature)"></a><a name="(mod-path._net/imap-sig)"></a>IMAP Signature</h4><p><table cellspacing="0" cellpadding="0" class="defmodule"><tr><td align="left"><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="#%28mod-path._net%2Fimap-sig%29" class="RktModLink" data-pltdoc="x"><span class="RktSym">net/imap-sig</span></a><span class="RktPn">)</span></td><td align="right"><span class="RpackageSpec"><span class="Smaller"> package:</span> <span class="stt">compatibility-lib</span></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>signature</p></div></div><p class="RForeground"><a name="(form._((lib._net/imap-sig..rkt)._imap~5e))"></a><span title="Provided from: net/imap-sig | Package: compatibility-lib"><span class="RktSym"><a href="#%28form._%28%28lib._net%2Fimap-sig..rkt%29._imap~5e%29%29" class="RktStxDef RktStxLink" data-pltdoc="x">imap^</a></span></span><span class="hspace"> </span>:<span class="hspace"> </span>signature</p></blockquote></td></tr></table></blockquote></div><div class="SIntrapara"><blockquote class="leftindent"></blockquote></div></p><p>Includes everything exported by the <a href="" class="RktModLink" data-pltdoc="x"><span class="RktSym">net/imap</span></a> module.</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="unihead.html" title="backward to "9 Header Field Encoding"" data-pltdoc="x">← prev</a> <a href="index.html" title="up to "Net: Networking Libraries"" data-pltdoc="x">up</a> <a href="pop3.html" title="forward to "11 POP3: Reading Mail"" data-pltdoc="x">next →</a></span> </div></div></div><div id="contextindicator"> </div></body></html>
|