dio_seek

dio_seek

(PHP 4 >= 4.2.0, PHP 5 <= 5.0.4)

dio_seek -- Cambia el posicionamiento en el archivo cuyo descriptor es fd a traves de los par谩metros pos y whence

Descripci贸n

int dio_seek ( resource fd, int pos, int whence )

La funci贸n dio_seek() se utiliza para cambiar el posicionamiento en el archivo cuyo descriptor es fd.

Lista de par谩metros

fd

El descriptor de archivo devuelto por la funci贸n dio_open().

pos

La nueva posici贸n.

whence

Indica la forma en que debe ser interpretado el par谩metro pos:

  • SEEK_SET (valor por defecto) - indica que se deben avanzar pos bytes desde el comienzo del archivo.

  • SEEK_CUR - indica que se deben avanzar pos bytes a partir de la posici贸n actual dentro del archivo. El avance puede ser tanto positivo como negativo.

  • SEEK_END - indica que se deben avanzar pos bytes desde el final del archivo. Un avance negativo implica una posici贸n dentro de la longitud original del archivo y un avance positivo implica una posici贸n m谩s alla de la longitud original del archivo. En este 煤ltimo caso en el que la posici贸n se encuentra fuera de los limites del archivo original, si se realiza una operaci贸n de escritura, las posiciones comprendidas entre el final del archivo original y la posici贸n de comienzo de los nuevos datos, se rellenar谩n con ceros.

Valores retornados

Ejemplos

Ejemplo 1. Posicionamiento en un archivo

<?php

$fd
= dio_open('/dev/ttyS0', O_RDWR);

dio_seek($fd, 10, SEEK_SET);
// La posicion actual es 10 caracteres despues del comienzo del archivo

dio_seek($fd, -2, SEEK_CUR);
// La posicion actual es 8 caracteres despues del comienzo del archivo

dio_seek($fd, -5, SEEK_END);
// La posicion actual es de 5 caracteres antes del fin del archivo

dio_seek($fd, 10, SEEK_END);
// La posicion actual es de 10 caracteres despues del fin del archivo.
// Los 10 caracteres que existen entre el final del archivo original y la
// posicion actual se rellenan con ceros.

dio_close($fd);
?>