std:: basic_ifstream

From cppreference.net

헤더 파일에 정의됨 `<fstream>`
template < class CharT, class Traits = std:: char_traits < CharT > > class basic_ifstream : public std:: basic_istream < CharT, Traits >

클래스 템플릿 basic_ifstream 은 파일 기반 스트림에 대한 고수준 입력 연산을 구현합니다. 이는 파일 기반 스트림 버퍼( std::basic_filebuf )를 고수준 인터페이스( std::basic_istream )와 연결합니다.

std::basic_ifstream 의 일반적인 구현은 오직 하나의 비파생 데이터 멤버만을 보유합니다: std:: basic_filebuf < CharT, Traits > 의 인스턴스입니다.

상속 다이어그램

일반적인 문자 타입에 대한 여러 typedef가 제공됩니다:

헤더 파일에 정의됨 `<fstream>`
타입	정의
`std::ifstream`	std :: basic_ifstream < char >
`std::wifstream`	std :: basic_ifstream < wchar_t >

멤버 타입	정의
`char_type`	`CharT`
`traits_type`	`Traits` ; 프로그램이 잘못된 형식입니다 만약 `Traits::char_type` 가 `CharT` 가 아닌 경우.
`int_type`	`Traits::int_type`
`pos_type`	`Traits::pos_type`
`off_type`	`Traits::off_type`
`native_handle_type` (C++26)	구현 정의 타입으로 TriviallyCopyable 이고 `semiregular` 입니다.

멤버 함수

(constructor)	파일 스트림을 생성함 (public member function)
(destructor) [virtual] (implicitly declared)	`basic_ifstream` 및 관련 버퍼를 소멸시키고 파일을 닫음 (virtual public member function)
operator= (C++11)	파일 스트림을 이동함 (public member function)
swap (C++11)	두 파일 스트림을 교환함 (public member function)
rdbuf	기본 raw 파일 장치 객체를 반환함 (public member function)
native_handle (C++26)	기본 구현 정의 핸들을 반환함 (public member function)
파일 연산
is_open	스트림에 연결된 파일이 있는지 확인함 (public member function)
open	파일을 열고 스트림과 연결함 (public member function)
close	연결된 파일을 닫음 (public member function)

비멤버 함수

std::swap (std::basic_ifstream)

(C++11)

std::swap 알고리즘을 특수화함
(함수 템플릿)

std:: basic_istream 로부터 상속됨

멤버 함수

형식화된 입력
operator>>	형식화된 데이터를 추출함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
비형식화된 입력
get	문자를 추출함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
peek	다음 문자를 추출하지 않고 읽음 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
unget	문자를 추출 취소함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
putback	입력 스트림에 문자를 넣음 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
getline	주어진 문자를 찾을 때까지 문자를 추출함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
ignore	주어진 문자를 찾을 때까지 문자를 추출하고 버림 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
read	문자 블록을 추출함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
readsome	이미 사용 가능한 문자 블록을 추출함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
gcount	마지막 비형식화 입력 작업으로 추출된 문자 수를 반환함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
위치 지정
tellg	입력 위치 표시자를 반환함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
seekg	입력 위치 표시자를 설정함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)
기타
sync	기본 저장 장치와 동기화함 ( `std::basic_istream<CharT,Traits>` 의 public 멤버 함수)

멤버 클래스

sentry

입력 작업을 위한 스트림 준비 기본 로직을 구현함
(


            std::basic_istream<CharT,Traits>

의 public 멤버 클래스)

std:: basic_ios 로부터 상속됨

멤버 타입

멤버 타입	정의
`char_type`	`CharT`
`traits_type`	`Traits`
`int_type`	`Traits::int_type`
`pos_type`	`Traits::pos_type`
`off_type`	`Traits::off_type`

멤버 함수

상태 함수
good	오류가 발생하지 않았는지 확인합니다 (즉, I/O 작업을 사용할 수 있는 상태) ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
eof	파일 끝에 도달했는지 확인합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
fail	오류가 발생했는지 확인합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
bad	복구 불가능한 오류가 발생했는지 확인합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
operator!	오류가 발생했는지 확인합니다 ( fail() 의 동의어) ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
operator bool	오류가 발생하지 않았는지 확인합니다 ( `!` fail() 의 동의어) ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
rdstate	상태 플래그를 반환합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
setstate	상태 플래그를 설정합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
clear	상태 플래그를 수정합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
서식 지정
copyfmt	서식 정보를 복사합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
fill	채움 문자를 관리합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
기타
exceptions	예외 마스크를 관리합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
imbue	로케일을 설정합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
rdbuf	연결된 스트림 버퍼를 관리합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
tie	연결된 스트림을 관리합니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
narrow	문자를 좁힙니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)
widen	문자를 넓힙니다 ( `std::basic_ios<CharT,Traits>` 의 public 멤버 함수)

std:: ios_base 에서 상속됨

멤버 함수

서식 지정
flags	형식 플래그 관리 ( `std::ios_base` 의 public member function)
setf	특정 형식 플래그 설정 ( `std::ios_base` 의 public member function)
unsetf	특정 형식 플래그 해제 ( `std::ios_base` 의 public member function)
precision	부동 소수점 연산의 소수점 정밀도 관리 ( `std::ios_base` 의 public member function)
width	필드 너비 관리 ( `std::ios_base` 의 public member function)
로캘
imbue	로캘 설정 ( `std::ios_base` 의 public member function)
getloc	현재 로캘 반환 ( `std::ios_base` 의 public member function)
내부 확장 가능 배열
xalloc [static]	`pword()` 및 `iword()` 의 인덱스로 사용하기에 안전한 프로그램 전체 고유 정수 반환 ( `std::ios_base` 의 public static member function)
iword	필요한 경우 전용 저장소 크기 조정 및 지정된 인덱스의 long 요소 접근 ( `std::ios_base` 의 public member function)
pword	필요한 경우 전용 저장소 크기 조정 및 지정된 인덱스의 void * 요소 접근 ( `std::ios_base` 의 public member function)
기타
register_callback	이벤트 콜백 함수 등록 ( `std::ios_base` 의 public member function)
sync_with_stdio [static]	C++과 C I/O 라이브러리 상호 운용성 설정 ( `std::ios_base` 의 public static member function)
멤버 클래스
failure	스트림 예외 ( `std::ios_base` 의 public member class)
Init	표준 스트림 객체 초기화 ( `std::ios_base` 의 public member class)

멤버 타입과 상수

유형 설명

openmode

스트림 열기 모드 타입

다음 상수들도 정의되어 있습니다:

상수	설명
`app`	각 쓰기 작업 전에 스트림의 끝으로 이동
`binary`	바이너리 모드 로 열기
`in`	읽기용으로 열기
`out`	쓰기용으로 열기
`trunc`	열 때 스트림의 내용을 버림
`ate`	열자마자 스트림의 끝으로 이동
`noreplace` (C++23)	배타적 모드로 열기

(typedef)

fmtflags

서식 플래그 타입

다음 상수들도 정의됩니다:

상수	설명
`dec`	정수 입출력에 10진법 사용: std::dec 참조
`oct`	정수 입출력에 8진법 사용: std::oct 참조
`hex`	정수 입출력에 16진법 사용: std::hex 참조
`basefield`	dec \| oct \| hex . 마스킹 연산에 유용함
`left`	왼쪽 정렬 (오른쪽에 채움 문자 추가): std::left 참조
`right`	오른쪽 정렬 (왼쪽에 채움 문자 추가): std::right 참조
`internal`	내부 정렬 (내부 지정 지점에 채움 문자 추가): std::internal 참조
`adjustfield`	left \| right \| internal . 마스킹 연산에 유용함
`scientific`	과학적 표기법으로 부동 소수점 타입 생성, fixed 와 결합 시 16진법 표기: std::scientific 참조
`fixed`	고정 소수점 표기법으로 부동 소수점 타입 생성, scientific 와 결합 시 16진법 표기: std::fixed 참조
`floatfield`	scientific \| fixed . 마스킹 연산에 유용함
`boolalpha`	알파벳 숫자 형식으로 bool 타입 삽입 및 추출: std::boolalpha 참조
`showbase`	정수 출력을 위한 숫자 체계 표시 접두사 생성, 통화 입출력에서 통화 표시자 요구: std::showbase 참조
`showpoint`	부동 소수점 숫자 출력에서 무조건 소수점 문자 생성: std::showpoint 참조
`showpos`	음수가 아닌 숫자 출력에 + 문자 생성: std::showpos 참조
`skipws`	특정 입력 연산 전 선행 공백 건너뜀: std::skipws 참조
`unitbuf`	각 출력 연산 후 출력 플러시: std::unitbuf 참조
`uppercase`	특정 출력 연산에서 일부 소문자를 대문자로 대체: std::uppercase 참조

(typedef)

iostate

스트림 상태 타입

다음 상수들도 정의됩니다:

상수	설명
`goodbit`	오류 없음
`badbit`	복구 불가능한 스트림 오류
`failbit`	입출력 연산 실패 (형식화 또는 추출 오류)
`eofbit`	관련 입력 시퀀스가 파일 끝에 도달함

(typedef)

seekdir

탐색 방향 타입

다음 상수들도 정의됩니다:

상수	설명
`beg`	스트림의 시작
`end`	스트림의 끝
`cur`	스트림 위치 표시자의 현재 위치

(typedef)

event

이벤트 타입 지정
(enum)

event_callback

콜백 함수 타입
(typedef)

참고 사항

Feature-test 매크로	값	표준	기능
`__cpp_lib_fstream_native_handle`	`202306L`	(C++26)	네이티브 핸들 지원

예제

이 코드 실행

#include <fstream>
#include <iostream>
#include <string>
int main()
{
    std::string filename = "Test.b";
    // 읽을 파일 준비
    double d = 3.14;
    std::ofstream(filename, std::ios::binary)
        .write(reinterpret_cast<char*>(&d), sizeof d) << 123 << "abc";
    // 파일을 읽기 위해 열기
    std::ifstream istrm(filename, std::ios::binary);
    if (!istrm.is_open())
        std::cout << "failed to open " << filename << '\n';
    else
    {
        double d;
        istrm.read(reinterpret_cast<char*>(&d), sizeof d); // 바이너리 입력
        int n;
        std::string s;
        if (istrm >> n >> s)                               // 텍스트 입력
            std::cout << "read back from file: " << d << ' ' << n << ' ' << s << '\n';
    }
}

출력:

read back from file: 3.14 123 abc

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Diagnostics library
Memory management library
Metaprogramming library (C++11)
General utilities library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Technical specifications
Symbols index
External libraries

I/O manipulators
Print functions (C++23)
C-style I/O
Buffers
basic_streambuf
basic_filebuf
basic_stringbuf
basic_spanbuf (C++23)
strstreambuf ( C++98/26* )
basic_syncbuf (C++20)
Streams
Abstractions
ios_base
basic_ios
basic_istream
basic_ostream
basic_iostream
File I/O
basic_ifstream
basic_ofstream
basic_fstream
String I/O
basic_istringstream
basic_ostringstream
basic_stringstream
Array I/O
basic_ispanstream (C++23)
basic_ospanstream (C++23)
basic_spanstream (C++23)
istrstream ( C++98/26* )
ostrstream ( C++98/26* )
strstream ( C++98/26* )
Synchronized Output
basic_osyncstream (C++20)
Types
streamoff
streamsize
fpos
Error category interface
iostream_category (C++11)
io_errc (C++11)

Member functions
basic_ifstream::basic_ifstream
basic_ifstream::operator= (C++11)
basic_ifstream::swap (C++11)
basic_ifstream::rdbuf
basic_ifstream::native_handle (C++26)
File operations
basic_ifstream::is_open
basic_ifstream::open
basic_ifstream::close
Non-member functions
swap (std::basic_ifstream) (C++11)

cppreference.net

Namespaces

Variants

std:: basic_ifstream

목차

멤버 타입

멤버 함수

파일 연산

비멤버 함수

std:: basic_istream 로부터 상속됨

멤버 함수

형식화된 입력

비형식화된 입력

위치 지정

기타

멤버 클래스

std:: basic_ios 로부터 상속됨

멤버 타입

멤버 함수

상태 함수

서식 지정

기타

std:: ios_base 에서 상속됨

멤버 함수

서식 지정

로캘

내부 확장 가능 배열

기타

멤버 클래스

멤버 타입과 상수

참고 사항

예제