php_stream_make

Manuel PHP
Précédent		Suivant

Description

int php_stream_make_seekable ( php_stream * origstream, php_stream ** newstream, int flags )

php_stream_make_seekable() vérifie si origstream dispose d'un pointeur de potision. Si ce n'est pas le cas, il va copier les données du flux dans un autre flux temporaire, et disposant d'un pointeur de position. Si cela fonctionne, newstream sera un flux valide même si le flux original avait déjà un pointeur de position.

flags vous permet de spécifier votre préférence pour le flux retourné : utilisez la constante PHP_STREAM_NO_PREFERENCE pour utiliser le flux à pointeur de position par défaut (qui utilise la mémoire, mais passe automatiquement sur un fichier si le fichier devient trop grand), ou bien utilisez PHP_STREAM_PREFER_STDIO pour utiliser un fichier temporaire classique.

Tableau 1. Valeurs retournées par php_stream_make_seekable()

Valeur	Signification
PHP_STREAM_UNCHANGED	Le flux original avait déjà son pointeur de position. `newstream` vaut `origstream`.
PHP_STREAM_RELEASED	Le flux originl n'avait pas pointeur de position, et il a été détruit. Vous n'avez plus accès à `origstream`.
PHP_STREAM_FAILED	Une erreur est survenue lors de la conversion. `newstream` vaut NULL; `origstream` est toujours valide.
PHP_STREAM_CRITICAL	Une erreur est survenue lors de la conversion de `origstream`, qui est maintenant dans un état indéterminé. `newstream` vaut NULL et il est très recommandé que vous vous fermiez `origstream`.

Note : Si vous devez déplacer le pointeur et écrire dans le flux, n'utilisez pas cette fonction, car le flux retourné est un flux mis en cache. Il n'est pas garantit qu'il soit lié à la ressource originale.

Note : Si vous avez uniquement de déplacer le pointeur de position vers l'avant, il n'y a pas besoin d'appeler cette fonction, car l'API va automatiquement émuler ce fonctionnement avec le paramètre whence à la valeur SEEK_CUR.

Note : Si origstream repose sur le réseau, cette fonction va se bloquer jusqu'à ce que tout le contenu soit téléchargé.

Note : Ne JAMAIS appeler cette fonction avec un flux origstream qui est une référence à un pointeur de fichier dans un script PHP. Cette fonction pourrait alors fermer le fichier, ce qui conduira à un crash au prochain accès au pointeur.

Note : Dans de nombreux cas, cette fonction ne peut réussir que si origstream vient d'être tout juste ouvert, et qu'aucune données n'ont été mises dans les caches de la couche de flux. Pour cette raison, et parce que cette fonction est compliquée à utiliser correctement, il est recommandé que vous utilisiez la fonction php_stream_open_wrapper() en lui passant la constante PHP_STREAM_MUST_SEEK dans vos options, au lieu d'appeler cette fonction directement.

Précédent	Sommaire	Suivant
php_stream_copy_to_mem	Niveau supérieur	php_stream_cast