std:: basic_iostream

From cppreference.net

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

클래스 템플릿 basic_iostream 은 스트림에 대한 고수준 입출력 연산을 지원합니다. 지원되는 연산에는 순차적 읽기/쓰기 및 포맷팅이 포함됩니다. 이 기능은 std::basic_streambuf 클래스가 제공하는 인터페이스를 통해 구현됩니다. 이는 std::basic_ios 클래스를 통해 접근됩니다.

상속 다이어그램

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

헤더 파일에 정의됨 `<istream>`
유형	정의
`std::iostream`	std :: basic_iostream < char >
`std::wiostream`	std :: basic_iostream < wchar_t >

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_ostream 에서 상속됨

멤버 함수

형식화된 출력
operator<<	형식화된 데이터를 삽입함 ( `std::basic_ostream<CharT,Traits>` 의 public 멤버 함수)
비형식화된 출력
put	문자를 삽입함 ( `std::basic_ostream<CharT,Traits>` 의 public 멤버 함수)
write	문자 블록을 삽입함 ( `std::basic_ostream<CharT,Traits>` 의 public 멤버 함수)
위치 지정
tellp	출력 위치 표시자를 반환함 ( `std::basic_ostream<CharT,Traits>` 의 public 멤버 함수)
seekp	출력 위치 표시자를 설정함 ( `std::basic_ostream<CharT,Traits>` 의 public 멤버 함수)
기타
flush	기본 저장 장치와 동기화함 ( `std::basic_ostream<CharT,Traits>` 의 public 멤버 함수)

멤버 클래스

sentry

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


            std::basic_ostream<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)

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

DR	적용 대상	게시된 동작	올바른 동작
LWG 271	C++98	멤버 타입 `char_type` , `traits_type` , `int_type` , `pos_type` 및 `off_type` 이 정의되지 않음 ( std::basic_istream 과 std::basic_ostream 모두 이 타입들을 정의하여 모호성이 발생함)	이 타입들을 정의함

참고 항목

입출력 조작자

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_iostream::basic_iostream
basic_iostream::~basic_iostream
Protected member functions
basic_iostream::operator=
basic_iostream::swap

(constructor)	객체를 생성한다 (public member function)
(destructor) [virtual]	객체를 소멸한다 (virtual public member function)

operator= (C++11)	다른 `basic_iostream` 을 이동 대입함 (protected 멤버 함수)
swap (C++11)	다른 `basic_iostream` 과 상태를 교환함 (public 멤버 함수)

cppreference.net

Namespaces

Variants

std:: basic_iostream

목차

멤버 타입

멤버 함수

보호된 멤버 함수

std:: basic_istream 로부터 상속됨

멤버 함수

형식화된 입력

비형식화된 입력

위치 지정

기타

멤버 클래스

std:: basic_ostream 에서 상속됨

멤버 함수

형식화된 출력

비형식화된 출력

위치 지정

기타

멤버 클래스

std:: basic_ios 로부터 상속됨

멤버 타입

멤버 함수

상태 함수

서식 지정

기타

std:: ios_base 에서 상속됨

멤버 함수

서식 지정

로캘

내부 확장 가능 배열

기타

멤버 클래스

멤버 타입과 상수

결함 보고서

참고 항목