Php/docs/function.dio-seek

提供:Dev Guides
< Php
移動先:案内検索

dio_seek

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

dio_seekfd 上で whence から pos に移動する


説明

dio_seek ( resource $fd , int $pos [, int $whence = SEEK_SET ] ) : int

関数 dio_seek() は、指定されたファイル記述子の ファイル内の位置を変更する際に使用されます。


パラメータ

fd
dio_open() が返すファイル記述子。
pos
新しい位置。
whence
位置 pos をどのように解釈するかを指示します。
  • SEEK_SET(デフォルト)- pos がファイル先頭からの位置であることを 指定します。
  • SEEK_CUR - pos が現在のファイル位置からの文字数である ことを指定します。このカウントは正にも負にもなりえます。
  • SEEK_END - pos がファイル終端からの文字数であることを 指定します。負の値は、現在のファイルの範囲内の位置を指定します。 正の値は、現在のファイル終端を越えた位置を指定します。ファイル終端を 超える位置を指定して実際にデータを書き込んだ場合、ファイルは その位置までゼロバイトで埋めて拡張されます。


返り値

例1 ファイル内の位置の指定

<?php$fd = dio_open('/dev/ttyS0', O_RDWR);dio_seek($fd, 10, SEEK_SET);// ファイル先頭から 10 文字目dio_seek($fd, -2, SEEK_CUR);// ファイル先頭から 8 文字目dio_seek($fd, -5, SEEK_END);// ファイル終端から 5 文字戻ったところdio_seek($fd, 10, SEEK_END);// ファイル終端からさらに 10 文字進んだところ。// ファイル終端と現在の位置の間は ゼロ で埋められる。dio_close($fd);?>