C++로 텍스트 파일을 한 줄씩 읽는 방법

C++ 프로그래밍에서 파일 입출력은 가장 기본적인 작업 중 하나이며, 그중에서도 텍스트 파일의 내용을 한 줄씩 읽어오는 방법은 로그 분석, 설정 파일 파싱, 대용량 데이터 처리 등 다양한 상황에서 활용됩니다. 이 글에서는 fstream 클래스와 getline() 함수를 이용해 파일을 한 줄씩 읽는 프로그램을 단계별로 살펴봅니다.

입력

tpoint.txt 파일에는 초기 내용으로
“Tutorials point.”가 저장되어 있습니다.

출력

Tutorials point.

알고리즘

시작
    fstream 클래스의 객체 newfile을 생성한다.
    open() 메서드를 호출하여 객체 newfile로 "tpoint.txt" 파일을 쓰기 모드로 연다.
    파일이 정상적으로 열렸다면
        tpoint.txt 파일에 문자열 "Tutorials point"를 입력한다.
        close() 메서드를 사용하여 파일 객체 newfile을 닫는다.
    open() 메서드를 호출하여 객체 newfile로 "tpoint.txt" 파일을 읽기 모드로 연다.
    파일이 정상적으로 열렸다면
        문자열 변수 "tp"를 선언한다.
        getline() 메서드를 사용하여 파일 객체 newfile의 모든 데이터를 읽어 문자열 tp에 저장한다.
        문자열 tp의 데이터를 출력한다.
    close() 메서드를 사용하여 파일 객체 newfile을 닫는다.
종료

예제 코드

#include <iostream>
#include <fstream>
#include <string>
using namespace std;

int main(){
    fstream newfile;
    newfile.open("tpoint.txt", ios::out);  // 파일 객체를 통해 쓰기 모드로 파일 열기
    if(newfile.is_open())                  // 파일이 정상적으로 열렸는지 확인
    {
        newfile << "Tutorials point \n";   // 텍스트 삽입
        newfile.close();                   // 파일 객체 닫기
    }
    newfile.open("tpoint.txt", ios::in);   // 파일 객체를 통해 읽기 모드로 파일 열기
    if(newfile.is_open()){                 // 파일이 정상적으로 열렸는지 확인
        string tp;
        while(getline(newfile, tp)){       // 파일 객체에서 데이터를 읽어 문자열에 저장
            cout << tp << "\n";            // 문자열의 데이터 출력
        }
        newfile.close();                   // 파일 객체 닫기
    }
}

실행 결과

Tutorials point.

코드 상세 설명

1. fstream과 파일 열기 모드

fstream은 C++ 표준 라이브러리에서 파일 입출력을 담당하는 클래스로, 읽기와 쓰기를 모두 지원합니다. open() 메서드 호출 시 두 번째 인자로 파일 모드를 지정하는데, ios::out은 쓰기 모드, ios::in은 읽기 모드를 의미합니다. 쓰기 모드로 파일을 열면 해당 파일이 없을 경우 새로 생성되며, 이미 존재하는 파일이라면 기존 내용이 사라진다는 점에 유의해야 합니다.

2. is_open()으로 파일 열기 여부 확인

파일이 실제로 열렸는지 반드시 확인하는 습관이 중요합니다. 파일이 존재하지 않거나 접근 권한이 없는 경우 open()이 실패할 수 있으며, is_open()은 이런 상황에서 false를 반환합니다. 조건문으로 검사하면 오류 상황을 안전하게 처리할 수 있습니다.

3. getline()으로 한 줄씩 읽기

getline()은 스트림 객체와 string 변수를 인자로 받아, 개행 문자(\n)를 만날 때까지 한 줄 전체를 읽어 문자열에 저장합니다. 파일의 끝(EOF)에 도달하면 false를 반환하기 때문에 while 루프의 조건으로 사용하면 파일 전체를 한 줄씩 순회할 수 있습니다. 공백이 포함된 문장도 잘림 없이 온전히 읽어온다는 점이 cin의 >> 연산자와의 큰 차이점입니다.

4. 파일 닫기

작업이 끝나면 반드시 close()를 호출하여 파일을 닫아야 합니다. 파일을 닫지 않으면 버퍼에 남아 있는 데이터가 디스크에 완전히 기록되지 않거나, 다른 프로세스가 해당 파일에 접근하지 못하는 문제가 발생할 수 있습니다.

마무리

이처럼 C++에서는 fstream 객체와 getline() 함수만으로도 파일을 손쉽게 한 줄씩 읽을 수 있습니다. 읽기 전용 작업이라면 ifstream을, 쓰기 전용 작업이라면 ofstream을 사용하는 것도 좋은 선택입니다. 또한 대용량 파일을 다룰 때는 내용을 한꺼번에 메모리에 올리지 않고 이처럼 한 줄씩 처리하는 방식이 메모리 효율 면에서 훨씬 유리합니다.

C++로 텍스트 파일을 한 줄씩 읽는 방법 – fstream과 getline() 활용

입력

출력