C 언어의 ftell() 함수

• 9/19/2025
• 2 minutes to read

ftell()는 C 언어의 표준 라이브러리 함수 중 하나로, 현재 파일 포인터의 위치를 long 타입으로 가져오는 데 사용됩니다. 이 함수는 stdio.h 헤더 파일에 선언되어 있습니다.

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

long ftell(FILE *stream);

ftell() 함수는 하나의 매개변수를 받습니다. 이 매개변수는 위치를 가져오려는 파일의 포인터를 나타냅니다. 함수는 성공적으로 위치를 가져왔다면 위치를 long 타입으로 반환하고, 그렇지 않다면 -1L을 반환합니다.

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

코드: ftell_function.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!");

    // 파일 포인터의 현재 위치 얻기
    long position = ftell(file);

    // 위치를 성공적으로 가져왔는지 확인하고 위치 출력
    if (position != -1L)
    {
        printf("파일 포인터의 현재 위치: %ld\n", position);
    }
    else
    {
        printf("위치를 가져오는데 실패했습니다.\n");
    }

    // 파일 닫기
    fclose(file);
    return 0;
}

파일 포인터의 현재 위치: 13

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