imap_uid

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_uid指定したメッセージシーケンス番号の UID を返す

説明

imap_uid(IMAP\Connection $imap, int $message_num): int|false

この関数は、指定したメッセージシーケンス番号の UID を返します。 メッセージ番号はメールボックスの内容を変更する度に変わる可能性が ありますが、UID はユニークな ID であり時間が経過しても変わりません。

この関数は、imap_msgno() の逆関数です。

パラメータ

imap

IMAP\Connection クラスのインスタンス。

message_num

メッセージ番号。

戻り値

指定したメッセージの UID を返します。

変更履歴

バージョン 説明
8.1.0 引数 imap は、IMAP\Connection クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、リソース が期待されていました。

注意

注意:

この関数は、POP3 メールボックスではサポートされません。

参考

  • imap_msgno() - 指定した UID のメッセージ番号を返す

関連キーワード:  メッセージ, 番号, UID, シーケンス, 指定, 関数, uid, Connection, クラス, 期待