# msg_stat_queue

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

msg_stat_queue — Liefert Informationen zur Datenstruktur einer Nachrichten-Warteschlange

### Beschreibung

msg_stat_queue(SysvMessageQueue `$queue`): array|false

msg_stat_queue() liefert die Metadaten zu der mit `queue` angegebenen Nachrichten-Warteschlange. Diese Informationen können z. B. genutzt werden, um herauszufinden welcher Prozess eine gerade empfangene Nachricht gesendet hat.

### Parameter-Liste

`queue`

  Die Nachrichten-Warteschlange.

### Rückgabewerte

Bei Erfolg ist der Rückgabewert ein Array, dessen Schlüssel und Werte die folgende Bedeutung haben:

Die Array-Struktur für msg_stat_queue
`msg_perm.uid` | Die Benutzer-ID des Besitzers der Warteschlange.
`msg_perm.gid` | Die Gruppen-ID des Besitzers der Warteschlange.
`msg_perm.mode` | Der Dateizugriffsmodus der Warteschlange.
`msg_stime` | Der Zeitpunkt, zu dem die letzte Nachricht an die Warteschlange gesendet wurde.
`msg_rtime` | Der Zeitpunkt, zu dem die letzte Nachricht von der Warteschlange empfangen wurde.
`msg_ctime` | Der Zeitpunkt, zu dem sich der Status der Warteschlange zuletzt geändert hat.
`msg_qnum` | Die Anzahl der Nachrichten, die sich zur Zeit noch in der Warteschlange befinden.
`msg_qbytes` | Die maximal erlaubte Anzahl von Bytes in einer Nachrichten-Warteschlange. Unter Linux kann dieser Wert über /proc/sys/kernel/msgmnb gelesen und verändert werden.
`msg_lspid` | Die Prozess-ID des Prozesses, der die letzte Nachricht an die Warteschlange gesendet hat.
`msg_lrpid` | Die Prozess-ID des Prozesses, der die letzte Nachricht aus der Warteschlange empfangen hat.

Gibt bei Auftreten eines Fehlers `false` zurück.

### Changelog

Version | Beschreibung
--- | ---
8.0.0 | `queue` erwartet nun eine SysvMessageQueue-Instanz; vorher wurde eine resource erwartet.

### Siehe auch

- msg_remove_queue() - Entfernt eine Nachrichten-Warteschlange
- msg_receive() - Liest eine Nachricht aus einer Nachrichten-Warteschlange aus
- msg_get_queue() - Legt eine Nachrichten-Warteschlange an oder hängt sich an existierende an
- msg_set_queue() - Setzt Metadaten in der Datenstruktur der Nachrichten-Warteschlange

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open