msg_get_queue

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

msg_get_queue Legt eine Nachrichten-Warteschlange an oder hängt sich an existierende an

Beschreibung

msg_get_queue(int $key, int $permissions = 0666): SysvMessageQueue|false

msg_get_queue() gibt eine ID zurück, die verwendet werden kann, um auf die mit key angegebene System-V-Nachrichten-Warteschlange zuzugreifen. Existiert die Nachrichten-Warteschlange noch nicht, so wird sie beim ersten Aufruf mit den im optionalen Parameter permissions angegebenen Rechten angelegt. Ein weiterer Aufruf von msg_get_queue() mit dem gleichen key liefert eine andere ID, beide IDs greifen aber intern auf die gleiche Nachrichten-Warteschlange zu.

Parameter-Liste

key

Numerische ID der Nachrichten-Warteschlange.

permissions

Zugriffsrechte der Warteschlange. Vorgabewert ist 0666. Existiert die Nachrichten-Warteschlange bereits, so wird dieser Parameter ignoriert.

Rückgabewerte

Gibt eine SysvMessageQueue-Instanz für den Zugriff auf eine System-V-Nachrichten-Warteschlange zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version Beschreibung
8.0.0 Bei Erfolg gibt diese Funktion nun eine SysvMessageQueue-Instanz zurück; vorher wurde eine resource zurückgegeben.

Siehe auch

  • msg_remove_queue() - Entfernt eine Nachrichten-Warteschlange
  • msg_receive() - Liest eine Nachricht aus einer Nachrichten-Warteschlange aus
  • msg_send() - Send a message to a message queue
  • msg_stat_queue() - Liefert Informationen zur Datenstruktur einer Nachrichten-Warteschlange
  • msg_set_queue() - Setzt Metadaten in der Datenstruktur der Nachrichten-Warteschlange