16.4.5 执行搜索

文件夹选中后，就可以用 IMAPClient 对象的 search()方法搜索电子邮件。search()
的参数是一个字符串列表，每一个格式化为 IMAP 搜索键。表 16-3 介绍了各种搜索键。
表 16-3    IMAP 搜索键
搜索键                   含义
'ALL'                            返回该文件夹中的所有邮件。如果你请求一个大文件夹中的所有消息，可能会遇到
imaplib 的大小限制。参见 16.4.6 小节“大小限制”

'BEFORE date', 'ON date', 'SINCE date'
'SUBJECT string', 'BODY string', 'TEXT string'
'FROM string', 'TO string', 'CC string', 'BCC string'
'SEEN', 'UNSEEN'

'ANSWERED', 'UNANSWERED'
'DELETED', 'UNDELETED'

'DRAFT', 'UNDRAFT'

这三个搜索键分别返回给定 date 之前、当天和之后 IMAP 服务器接收的消息。日期的格式必须像 05-Jul-2015。此外，虽然'SINCE 05-Jul-2015'将匹配 7 月 5 
日当天和之后的消息，但'BEFORE 05-Jul-2015'仅匹配 7 月 5 日之前的消息，不包括 7 月 5 日当天
分别返回 string 出现在主题、正文、主题或正文中的消息。如果 string 中有空格，就使用双引号：'TEXT "search with spaces"'

返回所有消息，其中 string 分别出现在“from”邮件地址，“to”邮件地址，“cc”（抄送）地址，或“bcc”（密件抄送）地址中。 如果 string 
中有多个电子邮件地址，就用空格将它们分开，并使用双引号： 'CC "firstcc@example.com secondcc@example.com"'
分别返回包含和不包含\ Seen 标记的所有信息。如果电子邮件已经被 fetch()方法调用访问（稍后描述），或者你曾在电子邮件程序或网络浏览器中点击过它，就会有\ 
Seen标记。比较常用的说法是电子邮件“已读”，而不是“已看”，但它们的意思一样。
分别返回包含和不包含\ Answered 标记的所有消息。如果消息已答复，就会有\ Answered 标记
分别返回包含和不包含\Deleted 标记的所有信息。用delete_messages()方法删除的邮件就会有\Deleted 标记，直到调用expunge()方法才会永久删除（请参阅16.4.10 
节“删除电子邮件”）。请注意，一些电子邮件提供商，例如Gmail，会自动清除邮件
分别返回包含和不包含\ Draft 标记的所有消息。草稿邮件通常保存在单独的草稿文件夹中，而不是在收件箱中

续表

搜索键                   含义

'FLAGGED', 'UNFLAGGED'
'LARGER N', 'SMALLER N'

分别返回包含和不包含\Flagged 标记的所有消息。这个标记通常用来标记电子邮件为“重要”或“紧急”
分别返回大于或小于 N 个字节的所有消息

'NOT search-key'         返回搜索键不会返回的那些消息

'OR search-key1 search-key2'

返回符合第一个或第二个搜索键的消息

请注意，在处理标志和搜索键方面，某些 IMAP 服务器的实现可能稍有不同。可能需要在交互式环境中试验一下，看看它们实际的行为如何。
在传入 search()方法的列表参数中，可以有多个 IMAP  搜索键字符串。返回的消息将匹配所有的搜索键。如果想匹配任何一个搜索键，使用 OR 搜索键。对于 NOT和 OR 
搜索键，它们后边分别跟着一个和两个完整的搜索键。
下面是 search()方法调用的一些例子，以及它们的含义： imapObj.search(['ALL'])  返回当前选定的文件夹中的每一个消息。 imapObj.search(['ON 
05-Jul-2015'])返回在 2015 年 7 月 5 日发送的每个消息。 imapObj.search(['SINCE  01-Jan-2015',  'BEFORE  
01-Feb-2015',  'UNSEEN'])
返回 2015 年 1 月发送的所有未读消息（注意，这意味着从 1 月 1 日直到 2 月 1 日，
但不包括 2 月 1 日）。
imapObj.search(['SINCE  01-Jan-2015',  'FROM  alice@example.com'])返回自
2015 年开始以来，发自 alice@example.com 的消息。
imapObj.search(['SINCE 01-Jan-2015', 'NOT FROM alice@example.com'])返回自 2015 年开始以来，除 
alice@example.com 外，其他所有人发来的消息。
imapObj.search(['OR FROM alice@example.com FROM bob@example.com'])
返回发自 alice@example.com 或 bob@example.com 的所有信息。
imapObj.search(['FROM  alice@example.com',  'FROM  
bob@example.com'])恶作剧例子！该搜索不会返回任何消息，因为消息必须匹配所有搜索关键词。因为只能有一个“from”地址，所以一条消息不可能既来自 
alice@example.com，又来自 bob@example.com。
search()方法不返回电子邮件本身，而是返回邮件的唯一整数 ID（UID）。然后，可以将这些 UID 传入 fetch()方法，获得邮件内容。
输入以下代码，继续交互式环境的例子：
>>>  UIDs  =  imapObj.search(['SINCE  05-Jul-2015'])
>>>  UIDs
[40032,  40033,  40034,  40035,  40036,  40037,  40038,  40039,  40040,  40041]
这里，search()返回的消息 ID 列表（针对 7 月 5 日以来接收的消息）保存在 UIDs

中。计算机上返回的 UIDs  列表与这里显示的不同，它们对于特定的电子邮件账户是唯一的。如果你稍后将 UID 传递给其他函数调用，请用你收到的 UID 值，而不是本书例子中打印的。