Namespaces
Variants

std:: basic_istream

From cppreference.net
< cpp ‎ | io
C++
Input/output library
std::basic_istream
헤더 파일에 정의됨 <istream>
template <

class CharT,
class Traits = std:: char_traits < CharT >

> class basic_istream : virtual public std:: basic_ios < CharT, Traits >

클래스 템플릿 basic_istream 은 문자 스트림에 대한 고수준 입력 연산을 지원합니다. 지원되는 연산에는 형식화된 입력(예: 정수 값이나 공백으로 구분된 문자 및 문자열)과 비형식화된 입력(예: 원시 문자 및 문자 배열)이 포함됩니다. 이 기능은 기본 basic_streambuf 클래스가 제공하는 인터페이스를 통해 구현되며, basic_ios 기본 클래스를 통해 접근됩니다. 대부분의 구현에서 basic_istream 의 유일하게 상속되지 않은 데이터 멤버는 basic_istream::gcount() 이 반환하는 값입니다.

cpp/io/ios base cpp/io/basic ios std-basic istream-inheritance.svg

상속 다이어그램

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

헤더 파일에 정의됨 <istream>
타입 정의
std::istream std :: basic_istream < char >
std::wistream std :: basic_istream < wchar_t >

목차

전역 객체

표준 라이브러리는 두 개의 전역 basic_istream 객체를 제공합니다.

헤더 파일에 정의됨 <iostream>
표준 C 입력 스트림으로부터 읽기 stdin
(전역 객체)

멤버 타입

멤버 타입 정의
char_type CharT
traits_type Traits ; Traits::char_type 가 CharT 가 아닌 경우 프로그램은 ill-formed입니다.
int_type Traits::int_type
pos_type Traits::pos_type
off_type Traits::off_type

멤버 함수

객체를 생성함
(public member function)
[virtual]
객체를 소멸시킴
(virtual public member function)
(C++11)
다른 basic_istream 으로부터 이동 대입함
(protected member function)
형식화된 입력
형식화된 데이터를 추출함
(public member function)
비형식화된 입력
문자를 추출함
(public member function)
다음 문자를 추출하지 않고 읽음
(public member function)
문자를 되돌림
(public member function)
입력 스트림에 문자를 넣음
(public member function)
주어진 문자를 찾을 때까지 문자를 추출함
(public member function)
주어진 문자를 찾을 때까지 문자를 추출하고 버림
(public member function)
문자 블록을 추출함
(public member function)
이미 사용 가능한 문자 블록을 추출함
(public member function)
마지막 비형식화 입력 연산으로 추출된 문자 수를 반환함
(public member function)
위치 지정
입력 위치 표시자를 반환함
(public member function)
입력 위치 표시자를 설정함
(public member function)
기타
기본 저장 장치와 동기화함
(public member function)
(C++11)
연결된 버퍼를 제외한 스트림 객체를 교환함
(protected member function)

멤버 클래스

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

비멤버 함수

문자 및 문자 배열 추출
(함수 템플릿)

std:: basic_ios 로부터 상속됨

멤버 타입

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

멤버 함수

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

std:: ios_base 에서 상속됨

멤버 함수

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

멤버 타입 및 상수

타입 설명
스트림 열기 모드 타입

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

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

(typedef)
서식 플래그 타입

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

상수 설명
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)
스트림 상태 타입

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

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

(typedef)
탐색 방향 타입

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

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

(typedef)
이벤트 타입 지정
(enum)
콜백 함수 타입
(typedef)