Опис

imap_sort(
    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 flags are 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 `imap`.
8.0.0	`reverse` is now bool instead of int.
8.0.0	`search_criteria` and `charset` are now nullable.