php_stream_seek

(no version information, might be only in CVS)

php_stream_seek -- Reubicar una secuencia

Descripción

int php_stream_seek ( php_stream * secuencia, off_t desplazamiento, int a_partir_de )

php_stream_seek() reubica la posición interna de secuencia. La nueva posición es determinada al sumar el desplazamiento a la posición indicada por a_partir_de. Si a_partir_de es definido como SEEK_SET, SEEK_CUR o SEEK_END, el desplazamiento es relativo al comienzo de la secuencia, la posición actual o el final de la secuencia, respectivamente.

php_stream_seek() devuelve 0 de tener éxito, y -1 si ocurrió un error.

Nota: No todas las secuencias soportan la reubicación, aunque la API de secuencias emulará la operación si a_partir_de es definido como SEEK_CUR y desplazamiento es un valor positivo, llamando php_stream_read() para leer (y descartar) tantos bytes como el valor de desplazamiento.

La emulación es aplicada únicamente cuando la implementación interna de la secuencia no soporta la reubicación. Si la secuencia es (por ejemplo) una secuencia basada en archivos que se encuentra envolviendo un pipe no-reubicable, la api de secuencias no aplicará la emulación ya que la secuencia basada en archivos implementa la operación; la reubicación fallará y se devolverá un resultado de error a la función que hace la llamada.

Hosting by: hurra.com
Generated: 2007-01-26 18:00:54