스트림과 파일 입출력 개요

지금까지 우리는 키보드로부터 데이터를 입력받고 (std::cin), 화면에 데이터를 출력하는 (std::cout) 콘솔 입출력을 주로 사용해 왔습니다.

하지만 프로그램의 데이터는 일회성으로 사용되는 경우가 많습니다.

프로그램이 종료되면 메모리에만 보관한 입력 데이터나 처리 결과는 사라집니다.

실제 응용 프로그램에서는 데이터를 영구적으로 저장하거나, 이전에 저장된 데이터를 불러와서 사용해야 할 필요가 있습니다.

이때 사용되는 것이 바로 파일 입출력(File I/O)입니다.

이 장에서는 C++에서 파일 입출력을 처리하는 기본 개념인 스트림(Stream)과 파일 입출력의 전체 구조를 정리합니다.

데이터 지속성 (Data Persistence)의 필요성

우리가 개발하는 프로그램은 종종 사용자 설정, 게임 진행 상황, 문서 내용, 이미지, 데이터베이스 정보 등 다양한 종류의 데이터를 다룹니다.

이러한 데이터가 프로그램 실행 중에만 존재하고 종료 시 사라진다면, 사용자는 매번 데이터를 다시 입력하거나 생성해야 하는 불편함을 겪게 됩니다.

데이터 지속성(Data Persistence)은 프로그램이 종료되더라도 데이터가 영구적으로 저장되어 다음 프로그램 실행 시에도 접근할 수 있도록 하는 능력입니다.

파일은 데이터를 지속적으로 저장하는 가장 기본적인 방법 중 하나입니다.

스트림 (Stream) 개념 이해하기

C++의 입출력은 스트림(Stream)이라는 추상적인 개념을 기반으로 합니다.

스트림은 데이터가 흐르는 통로(flow)를 의미합니다.

물이 흐르는 강물처럼 데이터도 한 곳에서 다른 곳으로 흘러간다고 생각할 수 있습니다.

• 출력 스트림 (Output Stream): 데이터가 프로그램에서 외부(화면, 파일 등)로 흘러나가는 통로입니다. std::cout이 대표적인 출력 스트림입니다.
• 입력 스트림 (Input Stream): 데이터가 외부(키보드, 파일 등)에서 프로그램으로 흘러들어오는 통로입니다. std::cin이 대표적인 입력 스트림입니다.

C++ 표준 라이브러리(iostream 및 fstream 헤더)는 이러한 스트림을 처리하기 위한 클래스들을 제공합니다.

• std::istream: 모든 입력 스트림의 기본 클래스입니다. std::cin이 이 클래스의 객체입니다.
• std::ostream: 모든 출력 스트림의 기본 클래스입니다. std::cout, std::cerr, std::clog가 이 클래스의 객체입니다.
• std::fstream: 파일 입출력을 위한 스트림 클래스입니다.

스트림 개념 덕분에 프로그래머는 형식화 인터페이스(<<, >>, getline 등)를 파일과 콘솔에 일관되게 사용할 수 있습니다.

이 인터페이스를 네트워크에 적용하려면 네트워크와 통신하는 std::streambuf 구현이나 라이브러리·플랫폼 어댑터가 필요합니다. C++ 표준 라이브러리가 네트워크 스트림 자체를 제공하는 것은 아닙니다.

예를 들어, 화면에 출력하는 것과 파일에 출력하는 것은 사용법이 거의 유사합니다.

파일 입출력의 기본 단계

스트림과 파일 입출력은 열기 모드, 상태 플래그, 읽기·쓰기 단위, close 책임으로 나누어 확인합니다.

in >> number;
std::getline(in >> std::ws, line);

in >> number;
std::getline(in >> std::ws, line);

스트림 객체를 고를 때는 데이터의 방향과 파일을 다루는 의도를 먼저 분리해서 보면 실수가 줄어듭니다.

C++에서 파일을 사용하여 데이터를 저장하고 불러오는 과정은 다음과 같은 기본 단계를 따릅니다.

#include <fstream> // 파일 입출력 클래스들을 위해
#include <limits>  // ignore에 사용할 최대 스트림 크기를 위해

// 출력 파일 스트림 객체 (파일에 쓸 때)
std::ofstream outputFile;

// 입력 파일 스트림 객체 (파일에서 읽을 때)
std::ifstream inputFile;

// 입출력 파일 스트림 객체 (읽고 쓸 때)
std::fstream ioFile;

outputFile.open("example.txt"); // 기본 인수 out, 기존 내용은 비움
inputFile.open("data.txt");     // 기본 인수 in
ioFile.open(
    "log.txt",
    std::ios::out | std::ios::app
); // fstream은 의도한 방향까지 명시

if (outputFile.is_open()) {
    // 파일 열기 성공
} else {
    // 파일 열기 실패
    std::cerr << "파일을 열 수 없습니다!" << std::endl;
}

// 파일에 쓰기 (출력 스트림)
outputFile << "Hello, File I/O!" << std::endl;
outputFile << 123 << " " << 45.67 << std::endl;

// 파일에서 읽기 (입력 스트림)
std::string line;
int number;
double value;
if (inputFile >> number >> value) { // 형식화 입력
    inputFile.ignore(
        std::numeric_limits<std::streamsize>::max(),
        '\n'
    ); // 남은 줄바꿈 제거
    std::getline(inputFile, line); // 다음 한 줄 읽기
}

outputFile.close();
inputFile.close();

간단한 파일 쓰기 예제

#include <iostream> // 콘솔 출력을 위해
#include <fstream>  // 파일 입출력을 위해
#include <string>   // std::string을 위해

int main() {
    // 1. 출력 파일 스트림 객체 생성
    std::ofstream outFile;

    // 2. 파일 열기 (파일이 없으면 생성, 있으면 내용 지움)
    outFile.open("my_output.txt"); // 기본적으로 std::ios::out 모드

    // 3. 파일 열기 성공 여부 확인
    if (outFile.is_open()) {
        // 4. 파일에 데이터 쓰기
        outFile << "이것은 파일에 쓰여질 첫 번째 줄입니다.\n";
        outFile << "숫자: " << 12345 << std::endl;
        outFile << "이름: " << "홍길동" << std::endl;

        // 쓰기와 닫기 중에 발생한 오류까지 확인
        outFile.close();
        if (!outFile) {
            std::cerr << "오류: 'my_output.txt' 쓰기 또는 닫기를 완료하지 못했습니다.\n";
            return 1;
        }

        std::cout << "파일 'my_output.txt'에 성공적으로 기록했습니다." << std::endl;
    } else {
        std::cerr << "오류: 'my_output.txt' 파일을 열 수 없습니다!" << std::endl;
        return 1;
    }

    return 0;
}

쓰기와 닫기를 완료하면 프로세스의 현재 작업 디렉터리에 있는 my_output.txt에 위 내용이 기록되고, 성공 메시지가 출력됩니다. 오류가 발생해도 파일이 이미 생성되었거나 기존 내용이 지워졌을 수 있고, 새 내용은 일부만 기록될 수 있습니다. 버퍼 동기화와 오류 처리는 텍스트 파일 쓰기에서 이어집니다.

간단한 파일 읽기 예제

파일 입출력은 방향 선택, 모드 지정, 연결 확인, 작업 결과 확인, RAII 정리의 책임으로 나누어 볼 수 있습니다.

#include <iostream> // 콘솔 출력을 위해
#include <fstream>  // 파일 입출력을 위해
#include <string>   // std::string을 위해

int main() {
    // 1. 입력 파일 스트림 객체 생성
    std::ifstream inFile;

    // 2. 파일 열기
    inFile.open("my_output.txt"); // 위에서 생성한 파일을 읽기 모드로 엶

    // 3. 파일 열기 성공 여부 확인
    if (inFile.is_open()) {
        // 4. 파일에서 데이터 읽기
        std::string line;
        // 파일 끝까지 한 줄씩 읽기
        while (std::getline(inFile, line)) { // inFile에서 한 줄을 읽어 line 변수에 저장
            std::cout << line << std::endl;
        }

        if (inFile.bad()) {
            std::cerr << "파일을 읽는 중 I/O 오류가 발생했습니다." << std::endl;
            return 1;
        }

        std::cout << "\n파일 'my_output.txt'에서 성공적으로 읽었습니다." << std::endl;

        // 이 예제에서는 스코프가 끝날 때 RAII로 닫힌다.
    } else {
        std::cerr << "오류: 'my_output.txt' 파일을 열 수 없습니다! (파일이 없거나 권한 문제)" << std::endl;
    }

    return 0;
}

위 코드를 실행하면, my_output.txt 파일의 내용을 한 줄씩 읽어 콘솔에 출력합니다.

쓰기와 읽기를 두 번의 실행으로 연결하기

새 실습 폴더에서 앞의 파일 쓰기 프로그램을 write-text.cpp, 읽기 프로그램을 read-text.cpp로 따로 저장합니다. main이 둘이므로 한 소스에 붙이지 않습니다. GCC에서는 각각 g++ -std=c++20 -Wall -Wextra write-text.cpp -o write-text.exe, g++ -std=c++20 -Wall -Wextra read-text.cpp -o read-text.exe로 빌드하세요. Windows PowerShell에서는 .\write-text.exe 다음 .\read-text.exe, Linux 셸에서는 ./write-text.exe 다음 ./read-text.exe를 같은 폴더에서 실행합니다.

쓰기의 성공 메시지 뒤 파일에는 첫 번째 줄·숫자 12345·이름 홍길동의 세 줄이 있습니다. 읽기는 그 세 줄을 출력한 뒤 빈 줄과 읽기 완료 메시지를 출력합니다. 파일을 여는 상대 경로는 소스 위치나 실행 파일 위치가 아니라 프로세스의 현재 작업 폴더를 기준으로 합니다. 저장된 파일이 존재하는지와 다음 프로그램이 같은 경로를 여는지를 함께 확인하세요.

조건을 바꾸어 판단하기

실행 파일만 빈 다른 폴더로 복사하고, 그 폴더를 작업 폴더로 삼아 read-text를 실행했습니다. my_output.txt는 복사하지 않았습니다. 저장했던 세 줄이 보일까요? 원 읽기 프로그램의 종료 코드 0만으로 읽기가 성공했다고 판단할 수 있나요?

파일 입출력 코드는 스트림 종류보다 먼저 “어떤 방향으로 열고, 열기 성공을 확인했는가”를 점검하면 예외 상황을 훨씬 차분하게 다룰 수 있습니다.