(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.