PHP 8.5.0 Alpha 1 available for testing

streamWrapper::stream_seek

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::stream_seekColoca el puntero de flujo en una posición

Descripción

public streamWrapper::stream_seek(int $offset, int $whence): bool

Este método es llamado en respuesta a fseek().

La posición de lectura/escritura debe ser modificada para reflejar la nueva posición offset y whence.

Parámetros

offset

La posición a buscar en el flujo.

whence

Los valores posibles son:

  • SEEK_SET: la nueva posición es offset bytes.
  • SEEK_CUR: la nueva posición es la posición actual más offset.
  • SEEK_END: la nueva posición es el final del fichero más offset.

Nota: La implementación actual nunca define whence como SEEK_CUR; de hecho, estas búsquedas de posición son convertidas internamente a búsquedas de tipo SEEK_SET.

Valores devueltos

Retorna true si la posición ha sido actualizada, false en caso contrario.

Notas

Nota:

Si no está implementado, false será utilizado como valor de retorno.

Nota:

En caso de éxito, streamWrapper::stream_tell() es llamado directamente después de streamWrapper::stream_seek(). Si streamWrapper::stream_tell() falla, el valor retornado a la función llamante es false.

Nota:

Todas las operaciones de desplazamiento en un flujo no requieren necesariamente el uso de esta función. Los flujos PHP tienen la lectura en búfer activada por omisión (ver también la función stream_set_read_buffer()) así como el desplazamiento en este flujo, que puede ser realizado moviendo el puntero del búfer.

Ver también

  • fseek() - Modifica la posición del puntero de archivo

add a note

User Contributed Notes 1 note

up
3
fb at tigermedia dot dk
11 years ago
Please notice that the return value of this function is a boolean but the return value of fseek is 0 for ok and -1 for failure.

Please use this implementation when working with files:

function stream_seek($offset, $whence) {
if(0 === fseek($this->_handler, $offset, $whence)){
return true;
}
return false;
}
To Top