imap_search
搜寻指定标准的信件。
语法: array imap_search(int imap_stream, string criteria, int flags);
传回值: 阵列
函式种类: 网路系统
本函用来搜寻合乎指定条件的信件。参数 imap_stream 为 IMAP 的代号。参数 criteria 为指定的条件,各栏位以空格 (space) 分开,条件见下表。参数 flags 为 SE_UID。
| 条件 | 说明 |
| ALL | 传回所有合乎标准的信件 |
| ANSWERED | 信件有设定 \\ANSWERED 旗标者 |
| BCC "字串" | Bcc 栏中有指定 "字串" 的信件 |
| BEFORE "日期" | 指定 "日期" 以前的信件 |
| BODY "字串" | 内文栏位中有指定 "字串" 的信件 |
| CC "字串" | Cc 栏中有指定 "字串" 的信件 |
| DELETED | 合乎已删除的信件 |
| FLAGGED | 信件有设定 \\FLAGGED 旗标者 |
| FROM "字串" | From 栏中有指定 "字串" 的信件 |
| KEYWORD "字串" | 关键字为指定 "字串" 者 |
| NEW | 新的信件 |
| OLD | 旧的信件 |
| ON "日期" | 指定 "日期" 的信件 |
| RECENT | 信件有设定 \\RECENT 旗标者 |
| SEEN | 信件有设定 \\SEEN 旗标者 |
| SINCE "日期" | 指定 "日期" 之后的信件 |
| SUBJECT "字串" | Subject 栏中有指定 "字串" 的信件 |
| TEXT "字串" | Text 栏中有指定 "字串" 的信件 |
| TO "字串" | To 栏中有指定 "字串" 的信件 |
| UNANSWERED | 未回应的信件 |
| UNDELETED | 未删除的信件 |
| UNFLAGGED | 未设定旗标的信件 |
| UNKEYWORD "字串" | 未设定关键 "字串" 的信件 |
| UNSEEN | 未读取的信件 |
|