C言語関数:fseek





C言語のページでは、次の内容を解説しております。
C言語の入門講座  C言語の文法を中心に、基本的な関数などの解説をしています。
C言語ケーススタディ  C言語での実践的なプログラミングについて解説をしています。
C言語の関数リファレンス  C言語で用意されている関数を解説しています。
C言語で3次元動画プログラム  C言語で3次元タートルグラフィックを使用した3次元の動画プログラムの作成例です。
C言語の検定試験  C言語の文法に関する検定試験を実施することができます。
C言語でゲーム作成  C言語を使用したゲームの作り方を解説したページも用意しております。



2014年10月より個人の方を対象に、Study C無料提供を開始しました。
C言語を勉強中の方は、学習・教育に最適なC言語インタープリタのStudy Cを使ってみてください(個人の方は無料です)。
大学・高専・高校などの教育機関での採用実績も多数あるロングセラー商品Study Cが、個人向けに無料提供を始めました。
インタープリタの手軽さに加え、ゲームや3Dタートルグラフィックで楽しく勉強したりと、C言語の学習を協力にサポートします。
ブロック崩しゲーム 3Dツリー クリスマスツリー
また、このようなボタンの用意されているページでは、掲載しているプログラムをStudy Cに直接ロードし実行したりすることができます。
Study Cにロードする Study Cにロードし編集する Study Cにロードし実行する
Study C無料利用についての詳細は、このページを参照してください。




■fseek
streamのファイルポインタを移動

【分類】
標準入出力/ストリーム関数

【書式】
int fseek(FILE *stream, long offset, int whence);

【パラメータの型と説明】

パラメータ説明
FILE *streamファイルポインタ(ストリーム)
long offset位置
int whence位置を指定する種類

【機能説明】

streamで指定されたストリームのファイルポインタをwhenceで指定された位置からoffsetバイト離れたところに移動します。
whence = 0 のとき ファイルの先頭から
whence = 1 のとき 現在のファイルポインタから
whence = 2 のとき ファイルの終わりから

ファイルポインタの移動に成功したときは0を、失敗したときは0でない値を返します。

fseek()関数の使用例です。 「test.txt」というファイルの内容を読み込むプログラムです。 実行する前に、ファイルを作成しておく必要があります。 次のコマンドでファイルを作成してください。

C:\StudyC\MyProg>echo test file>test.txt

C:\StudyC\MyProg>echo line add>>test.txt

C:\StudyC\MyProg>type test.txt
test file
line add

これで読み書き可能な(普通の状態)ファイル「test.txt」が作成されました。
※echoコマンドは画面に文字列を表示するものです。 他の多くのコマンドでも同じですが、最後に「>ファイル名」を指定すると画面に表示される内容がファイルに書き込まれます。 また、「>>ファイル名」とするとファイルに追記されます。

#include <stdio.h>

main()
{
        FILE    *fp;
        char    buff[100+1];
        char    *rc;

        fp = fopen("test.txt", "r");
        if (fp == NULL)
        {
                printf("ファイルオープンエラー\n");
                return;
        }
        rc = fgets(buff, 100, fp);
        if (rc == NULL)
        {
                printf("読み込みデータなし\n");
        }
        else
        {
                printf("fgets:%s\n", buff);
        }

        rc = fgets(buff, 100, fp);
        if (rc == NULL)
        {
                printf("読み込みデータなし\n");
        }
        else
        {
                printf("fgets:%s\n", buff);
        }

        rc = fgets(buff, 100, fp);
        if (rc == NULL)
        {
                printf("読み込みデータなし\n");
        }
        else
        {
                printf("fgets:%s\n", buff);
        }

        printf("fseek:%d\n", fseek(fp, 11, 0));

        rc = fgets(buff, 100, fp);
        if (rc == NULL)
        {
                printf("読み込みデータなし\n");
        }
        else
        {
                printf("fgets:%s\n", buff);
        }

        fclose(fp);
}

実行結果は以下になります。

fgets:test file

fgets:line add

読み込みデータなし
fseek:0
fgets:line add

1.fopen()関数で「test.txt」ファイルをオープンします。
「ファイルオープンエラー」と表示される場合は、事前にファイルが作成できていない可能性があるので確認してください。
2.fgets()関数でファイル「test.txt」の内容を1行読み込みます(最大100バイト)。
3.printf()関数で読み込んだ内容を表示します。
4.同様にfgets()関数で2行目を読み込みます(最大100バイト)。
5.printf()関数で読み込んだ内容を表示します。
6.再度fgets()関数で読み込もうとしますが、ファイルの最後に到達しているのでNULLが返されます。
7.fseek()関数で読み込み位置をファイルの先頭から11バイト目に戻します。
8.fgets()関数でファイル「test.txt」の内容を1行読み込みます(最大100バイト)。 2行目のファイルの内容が読み込まれます。

2行目の先頭のファイル内での位置は、「test line」の9バイトと改行のバイト数になります。
Windowsでは改行が「0x0D 0x0A」の2バイトで構成されているので、11バイト目が2行目の先頭の位置になります。

【参照関数】
ftell
rewind
lseek