Manual de PHP
Anterior	Capítulo 63. API de Secuencia para Autores de Extensiones PHP	Siguiente

Conceptos Básicos de Secuencias

El uso de secuencias es bastante similar al uso de funciones stdio ANSI. La principal diferencia está en el modo en que obtiene en un principo el gestor de la secuencia. En la mayoría de casos, usted usará php_stream_open_wrapper() para obtener el gestor de secuencia. Esta función trabaja de forma muy similar a fopen, y puede apreciarse en el siguiente ejemplo:

Ejemplo 63-1. ejemplo simple de secuencia que despliega la página de inicio de PHP
php_stream * stream = php_stream_open_wrapper("http://www.php.net", "rb", REPORT_ERRORS, NULL); if (stream) { while(!php_stream_eof(stream)) { char buf[1024]; if (php_stream_gets(stream, buf, sizeof(buf))) { printf(buf); } else { break; } } php_stream_close(stream); }

La tabla a continuación muestra los equivalentes de Secuencia a las funciones más comunes de stdio ANSI. A menos que se note lo contrario, las semánticas de las funciones son idénticas.

Tabla 63-1. Funciones equivalentes a stdio ANSI en la API de Secuencias

Función Stdio ANSI	Función de Secuencias PHP	Notas
fopen	php_stream_open_wrapper	Las secuencias incluyen parámetros opcionales
fclose	php_stream_close
fgets	php_stream_gets
fread	php_stream_read	Se asume que el parámetro nmemb tiene un valor de 1, así que el prototipo luce más como read(2)
fwrite	php_stream_write	Se asume que el parámetro nmemb tiene un valor de 1, así que el prototipo luce más como write(2)
fseek	php_stream_seek
ftell	php_stream_tell
rewind	php_stream_rewind
feof	php_stream_eof
fgetc	php_stream_getc
fputc	php_stream_putc
fflush	php_stream_flush
puts	php_stream_puts	La misma semántica que puts, NO fputs
fstat	php_stream_stat	Las secuencias tienen una estructura stat más rica

Anterior	Inicio	Siguiente
API de Secuencia para Autores de Extensiones PHP	Subir	Las Secuencias como Recursos