C 언어의 fseek() 함수

• 9/19/2025
• 3 minutes to read

fseek 함수는 C 프로그래밍 언어에서 파일의 포인터 위치를 임의의 위치로 이동시키는데 사용하는 표준 라이브러리 함수입니다. 이 함수를 사용하여 파일 내의 특정 위치로 점프하거나, 파일의 특정 부분만 읽고 쓰는 등의 작업을 할 수 있습니다. fseek 함수는 stdio.h 헤더 파일에 정의되어 있습니다.

함수의 원형은 다음과 같습니다.

int fseek(FILE *stream, long offset, int whence);

• stream은 위치를 변경할 파일의 포인터입니다.
• offset은 이동할 바이트 수를 나타내며, 양수이면 앞으로 이동하고 음수이면 뒤로 이동합니다.
• whence는 offset의 기준 위치를 지정합니다. 이 값은 다음 세 가지 중 하나가 될 수 있습니다:
  • SEEK_SET : 파일의 시작을 기준으로 합니다.
  • SEEK_CUR : 파일 포인터의 현재 위치를 기준으로 합니다.
  • SEEK_END : 파일의 끝을 기준으로 합니다.

fseek 함수는 성공적으로 실행되면 0을 반환하고, 실패하면 0이 아닌 값을 반환합니다.

아래는 fseek() 함수를 이용하여 파일 포인터의 위치를 이동하는 간단한 예제입니다:

코드: fseek_example.c

#define _CRT_SECURE_NO_WARNINGS
#include <stdio.h>

int main(void)
{
    // "test.txt" 파일을 읽기-쓰기 모드로 연다.
    FILE* file = fopen("test.txt", "w+");

    // 파일 열기가 실패한 경우 에러 메시지를 출력한다.
    if (file == NULL)
    {
        printf("파일을 열 수 없습니다.\n");
        return 1;
    }

    // "Hello, World!" 문자열을 파일에 쓴다.
    fprintf(file, "Hello, World!");

    // 파일 포인터의 위치를 파일 시작으로부터 7바이트 뒤로 이동한다.
    if (fseek(file, 7, SEEK_SET) == 0)
    {
        printf("파일 포인터의 위치가 성공적으로 변경되었습니다.\n");
    }
    else
    {
        printf("위치를 변경하는데 실패했습니다.\n");
        fclose(file);
        return 1;
    }

    // 파일에서 문자열을 읽어와서 출력한다.
    char buffer[20];
    if (fgets(buffer, sizeof(buffer), file) != NULL)
    {
        printf("파일로부터 읽은 문자열: %s\n", buffer);
    }
    else
    {
        printf("파일로부터 읽기를 실패했습니다.\n");
    }

    // 파일을 닫는다.
    fclose(file);
    return 0;
}

파일 포인터의 위치가 성공적으로 변경되었습니다.
파일로부터 읽은 문자열: World!

위 코드는 "test.txt"라는 이름의 파일을 읽기-쓰기 모드("w+")로 열고, fprintf() 함수를 사용하여 문자열 "Hello, World!"를 파일에 기록합니다. 데이터 쓰기가 끝난 후, fseek() 함수를 사용하여 파일 포인터의 위치를 변경합니다. 위치를 성공적으로 변경한 다음에는 fgets() 함수를 사용하여 파일로부터 문자열을 읽고, printf() 함수로 출력합니다. 작업이 모두 끝난 후, fclose() 함수를 사용하여 파일을 닫습니다.