C 언어의 fsetpos() 함수

• 9/19/2025
• 2 minutes to read

fsetpos()는 C 언어의 표준 라이브러리 함수 중 하나로, 파일 포인터의 위치를 설정하는 데 사용됩니다. 이 함수는 stdio.h 헤더 파일에 선언되어 있습니다.

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

int fsetpos(FILE *stream, const fpos_t *pos);

fsetpos() 함수는 두 개의 매개변수를 받습니다. 첫 번째 매개변수는 위치를 설정하려는 파일의 포인터를, 두 번째 매개변수는 설정할 위치 정보를 가지고 있는 fpos_t 타입 변수의 포인터를 나타냅니다. 함수는 성공적으로 위치를 설정했다면 0을, 그렇지 않다면 non-zero 값을 반환합니다.

아래는 fsetpos() 함수를 이용하여 파일 포인터의 위치를 설정하는 간단한 C 프로그램 예제입니다:

#include <stdio.h>

int main() {
    FILE *file = fopen("test.txt", "w+");
    if (file == NULL) {
        printf("파일을 열 수 없습니다.\n");
        return 1;
    }

    fprintf(file, "Hello, World!");

    fpos_t position = 6;
    if (fsetpos(file, &position) == 0) {
        printf("파일 포인터의 위치가 성공적으로 설정되었습니다.\n");
    } else {
        printf("위치를 설정하는데 실패했습니다.\n");
    }

    fclose(file);
    return 0;
}

위 코드는 "test.txt"라는 이름의 파일을 읽기-쓰기 모드("w+")로 열고, fprintf() 함수를 사용해 문자열 "Hello, World!"를 파일에 씁니다. 데이터 쓰기가 끝나면 fsetpos() 함수를 사용해 파일 포인터의 위치를 설정합니다. 위치를 성공적으로 설정했다면 적절한 메시지를 출력합니다. 작업이 모두 끝나면 fclose() 함수를 사용해 파일을 닫습니다.