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() 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
