array imap_search (int imap_stream, string criteria, int flags)
Эта функция выполняет поиск в mailbox’е, открытом в данный момент в imap-потоке. criteria это строка, ограниченная пробелами, в которой допускается наличие ключевых
слов. Любые многословные аргументы (например, FROM "joey smith") обязаны быть в кавычках.
ALL - возвращать все сообщения, соответствующие остальной части критерия
ANSWERED - совпадать с сообщениями с установленным флагом \ANSWERED
BCC "string" - совпадать с сообщениями со "string" в поле Bcc:
BEFORE "date" - совпадать с сообщениями с Date: перед "date"
BODY "string" - совпадать с сообщениями со "string" в теле сообщения
CC "string" - совпадать с сообщениями со "string" в поле Cc:
DELETED - совпадать с удалёнными сообщениями
FLAGGED - совпадать с сообщениями с установленным флагом \FLAGGED (иногда
называемым Important или Urgent)
FROM "string" - совпадать с сообщениями со "string" в поле From:
KEYWORD "string" - совпадать с сообщениями со "string" - ключевым словом
NEW - совпадать с новыми сообщениями
OLD - совпадать со старыми сообщениями
ON "date" - совпадать с сообщениями с Date: совпадающей с "date"
RECENT - совпадать с сообщениями с установленным флагом \RECENT
SEEN - совпадать с прочитанными сообщениями (установлен флаг \SEEN)
SINCE "date" - совпадать с сообщениями с Date: после "date"
SUBJECT "string" - совпадать с сообщениями со "string" в поле Subject:
TEXT "string" - совпадать с сообщениями с текстовой "string"
TO "string" - совпадать с сообщениями со "string" в поле To:
UNANSWERED - совпадать с сообщениями, на которые не дан ответ
UNDELETED - совпадать с сообщениями, которые не удалены
UNFLAGGED - совпадать с сообщениями, которые не помечены флагами
UNKEYWORD "string" - совпадать с сообщениями, не имеющими ключевого слова "string"
UNSEEN - совпадать с сообщениями, которые ещё не прочитаны
Например, чтобы найти все сообщения от Mom, на которые не даны ответы, можно использовать: "UNANSWERED FROM mom". Поиск происходит без учёта
регистра. Этот список критериев взят из исходного кода UW c-клиента и может быть неполным и неточным (см. также RFC2060, раздел 6.4.4).
Правильными значениями флагов являются SE_UID, тогда возвращаемый массив содержит UID’ы вместо номеров последовательности сообщений.
