User manual - Cライブラリ解説書ver.2.00(2003年2月7日)

DT-900 C ライブラリ解説書
32
機能 ファイルリード／ライト位置の設定 関数名 lseek
＜低水準インタフェース関数＞
指定ファイルの読込／書込位置をバイト単位で設定します。
正常終了した場合は、ファイルの先頭からオフセットを返します。
≪Ｃ言語インタフェース≫
【コーリングシーケンス】
int ercd = lseek(int fileno， long offset， int base) ;
【パラメータ】
int fileno ：対象のファイル番号
long offset ：読込み／書込み位置の変更先
base で指定された位置からのオフセット値 （バイト単位）
int base ：０の時、ファイルの先頭を基準とします
１の時、現在の読込み／書込み位置を基準とします
２の時、ファイルの最後を基準とします
【リターンパラメータ】
int ercd ：正常終了時は、変更した位置情報を返します
ファイルの先頭からオフセットアドレス（バイト単位）
・更新した書込み位置が負の場合、現在位置は更新されません
・更新した書込み位置がファイルサイズを超えた場合、現在位置は更新されません
異常終了時は、リターンコードを返します
【リターンコード】
E_LOWERR ：異常終了
・ファイル未オープン
・更新した読込み／書込み位置が負
・更新した読込み／書込み位置がファイルサイズを超えた
≪備考≫