imap_sort
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_sort — Gets and sort messages
說明
imap_sort(
IMAP\Connection
int
bool
int
?string
?string
): array|false
IMAP\Connection
$imap,int
$criteria,bool
$reverse,int
$flags = 0,?string
$search_criteria = null,?string
$charset = null): array|false
Gets and sorts message numbers by the given parameters.
參數
-
imap -
IMAP\Connection 實例。
-
criteria -
Criteria can be one (and only one) of the following:
-
SORTDATE- message Date -
SORTARRIVAL- arrival date -
SORTFROM- mailbox in first From address -
SORTSUBJECT- message subject -
SORTTO- mailbox in first To address -
SORTCC- mailbox in first cc address -
SORTSIZE- size of message in octets
-
-
reverse -
Whether to sort in reverse order.
-
flags -
The
flagsare a bitmask of one or more of the following:-
SE_UID- Return UIDs instead of sequence numbers -
SE_NOPREFETCH- Don't prefetch searched messages
-
-
search_criteria -
IMAP2-format search criteria string. For details see imap_search().
-
charset -
MIME character set to use when sorting strings.
返回值
Returns an array of message numbers sorted by the given
parameters, 或者在失敗時返回 false.
更新日誌
| 版本 | 說明 |
|---|---|
| 8.1.0 |
現在 imap 參數接受 IMAP\Connection
實例，之前接受 資源(resource)。
|
| 8.0.0 |
reverse is now bool instead of int.
|
| 8.0.0 |
search_criteria and charset are now nullable.
|