User manual - Cライブラリ解説書ver.1.01(2006年6月15日)

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