Forum und email

stream_get_meta_data

(PHP 4 >= 4.3.0, PHP 5)

stream_get_meta_data — Lit les en-têtes et données méta des flux

Description

array stream_get_meta_data ( resource $stream )

stream_get_meta_data retourne les informations disponibles sur le flux stream . Ce flux peut être n'importe quel flux créé par fopen(), fsockopen() et pfsockopen(). Le tableau résultant peut contenir les éléments suivants :

  • timed_out (booléen) - TRUE si le flux a atteint de délai d'expiration en attendant des données durant le dernier appel aux fonctions fread() et fgets().

  • blocked (booléen) - TRUE si le flux est en mode bloquant. Voir aussi stream_set_blocking().

  • eof (booléen) - TRUE si le flux a atteint la fin du fichier. Notez que pour les sockets, cette valeur peut être TRUE même si unread_bytes est non nul. Pour déterminer s'il reste des données à lire, utilisez plutôt la fonction feof().

  • unread_bytes (entier) - le nombre d'octets actuellement placés dans le buffer interne à PHP.

    Note: Vous ne devriez pas utiliser cette valeur dans un script.

Les éléments suivants ont été ajoutés en PHP 4.3.0 :

Note: Cette fonction a été introduite en PHP 4.3.0, mais avant cette version, socket_get_status() était utilisée pour lire les 4 premiers éléments, uniquement pour les sockets.
En PHP 4.3.0 et plus récent, socket_get_status() est un alias de la fonction de cette fonction.

Note: Cette fonction n'est pas utilisable avec les sockets créées par les fonctions de l'extension socket.

Les éléments suivants ont été ajoutés en PHP 5.0.0: