std::basic_string

 

C++

컴파일러 지원

Freestanding and hosted

언어

표준 라이브러리 헤더

명명된 요구사항

Feature test macros (C++20)

언어 지원 라이브러리

개념(C++20)

Diagnostics library

유틸리티 라이브러리

문자열 라이브러리

컨테이너 라이브러리

반복자 라이브러리

범위 라이브러리(C++20)

알고리즘 라이브러리

수치 라이브러리

지역화 라이브러리

입/출력 라이브러리

파일시스템 라이브러리(C++17)

정규 표현식 라이브러리(C++11)

아토믹 연산 라이브러리(C++11)

쓰레드 지원 라이브러리(C++11)

Technical specifications

Symbols index

외부 라이브러리들

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

char_traits

 

std::basic_string

Member functions basic_string::basic_string basic_string::operator= basic_string::assign basic_string::get_allocator Element access basic_string::at basic_string::operator[] basic_string::front (C++11) basic_string::back (C++11) basic_string::data basic_string::c_str Iterators basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Capacity basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (C++11)

Operations basic_string::clear basic_string::insert basic_string::erase basic_string::push_back basic_string::pop_back (C++11) basic_string::append basic_string::operator+= basic_string::compare basic_string::replace basic_string::substr basic_string::copy basic_string::resize basic_string::swap Search basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of Constants basic_string::npos

Non-member functions operator+ operator==operator!=operator<operator>operator<=operator>= swap(std::basic_string) operator<<operator>> getline stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11) stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Helper classes hash<std::string>hash<std::wstring>hash<std::u32string>hash<std::u16string> (C++11)

 

<string> 에 정의되어 있음.
template<     class CharT,     class Traits =std::char_traits<CharT>,     class Allocator =std::allocator<CharT> >class basic_string;

basic_string 클래스 템플릿은 char 또는 이와 유사한 객체의 시퀀스를 저장하고 조작합니다. 이 클래스는 문자 자료형이나 그것의 연산에 관한 성질에 의존적이지 않습니다. 대신에 이러한 연산의 정의는 Traits 템플릿 매개변수로부터 주어지는데, 이는 특수화된 std::char_traits이거나 이와 호환되는 traits 클래스입니다.

The elements of a basic_string are stored contiguously, that is, for a basic_string s, &*(s.begin()+ n)==&*s.begin()+ n for any n in [0, s.size()), or, equivalently, a pointer to s[0] can be passed to functions that expect a pointer to the first element of a CharT[] array.

(since C++11)

공통 문자 타입을 위한 몇몇 자료형이 정의되어 있으며, 아래와 같습니다.

<string> 헤더에 정의됨.
자료형	정의
std::string	std::basic_string<char>
std::wstring	std::basic_string<wchar_t>
std::u16string(C++11)	std::basic_string<char16_t>
std::u32string(C++11)	std::basic_string<char32_t>

템플릿 매개변수

CharT	-	문자 타입
Traits	-	문자 타입에 대한 연산을 정의하는 traits 클래스
Allocator	-	내부 저장소를 할당하기 위한 Allocator 타입

멤버 자료형

멤버 자료형	정의
traits_type	Traits
value_type	Traits::char_type
allocator_type	할당자
size_type	부호 없는 정수(unsigned int) 타입 (일반적으로 std::size_t)
difference_type	부호 있는 정수(signed int) 타입 (보통 std::ptrdiff_t)
reference	Allocator::reference(until C++11) value_type&(since C++11)
const_reference	Allocator::const_reference(until C++11) const value_type&(since C++11)
pointer	Allocator::pointer(until C++11) std::allocator_traits<Allocator>::pointer(since C++11)
const_pointer	Allocator::const_pointer(until C++11) std::allocator_traits<Allocator>::const_pointer(since C++11)
iterator	RandomAccessIterator
const_iterator	상수(constant) 양방향 반복자(iterator)
reverse_iterator	std::reverse_iterator<iterator>
const_reverse_iterator	std::reverse_iterator<const_iterator>

Member functions

(constructor)	constructs a basic_string (public member function)
operator=	assigns values to the string (public member function)
assign	assign characters to a string (public member function)
get_allocator	returns the associated allocator (public member function)
Element access
at	access specified character with bounds checking (public member function)
operator[]	access specified character (public member function)
front (C++11)	accesses the first character (public member function)
back (C++11)	accesses the last character (public member function)
data	returns a pointer to the first character of a string (public member function)
c_str	returns a non-modifiable standard C character array version of the string (public member function)
Iterators
begin cbegin (C++11)	returns an iterator to the beginning (public member function)
end cend (C++11)	returns an iterator to the end (public member function)
rbegin crbegin (C++11)	returns a reverse iterator to the beginning (public member function)
rend crend (C++11)	returns a reverse iterator to the end (public member function)
Capacity
empty	checks whether the string is empty (public member function)
size length	returns the number of characters (public member function)
max_size	returns the maximum number of characters (public member function)
reserve	reserves storage (public member function)
capacity	returns the number of characters that can be held in currently allocated storage (public member function)
shrink_to_fit (C++11)	reduces memory usage by freeing unused memory (public member function)
Operations
clear	clears the contents (public member function)
insert	inserts characters (public member function)
erase	removes characters (public member function)
push_back	appends a character to the end (public member function)
pop_back (C++11)	removes the last character (public member function)
append	appends characters to the end (public member function)
operator+=	appends characters to the end (public member function)
compare	compares two strings (public member function)
replace	replaces specified portion of a string (public member function)
substr	returns a substring (public member function)
copy	copies characters (public member function)
resize	changes the number of characters stored (public member function)
swap	swaps the contents (public member function)
Search
find	find characters in the string (public member function)
rfind	find the last occurrence of a substring (public member function)
find_first_of	find first occurrence of characters (public member function)
find_first_not_of	find first absence of characters (public member function)
find_last_of	find last occurrence of characters (public member function)
find_last_not_of	find last absence of characters (public member function)
Constants
npos [static]	special value. The exact meaning depends on the context (public static member constant)

Non-member functions

operator+	두 문자열 또는 문자열과 문자를 이어붙입니다 (function template)
operator== operator!= operator< operator> operator<= operator>=	두 문자열을 사전순으로 비교합니다 (function template)
std::swap(std::basic_string)	std::swap 알고리즘을 특수화합니다 (function template)
Input/output
operator<< operator>>	문자열에 대한 스트림 입력 및 출력을 수행합니다 (function template)
getline	입·출력 스트림으로부터 문자열로 데이터를 읽어들입니다 (function)
Numeric conversions
stoi stol stoll (C++11) (C++11) (C++11)	문자열을 부호 있는 정수로 변환합니다 (function)
stoul stoull (C++11) (C++11)	문자열을 부호 없는 정수로 변환합니다 (function)
stof stod stold (C++11) (C++11) (C++11)	문자열을 부동소숫점 값으로 변환합니다 (function)
to_string (C++11)	정수 또는 부동소숫점 값을 string으로 변환합니다 (function)
to_wstring (C++11)	정수 또는 부동소숫점 값을 wstring으로 변환합니다 (function)

Literals

Defined in namespace std::literals::string_literals
operator""s (C++14)	널 문자 종결 문자열로부터 basic_string을 반환합니다 (function)

Helper classes

std::hash<std::string> std::hash<std::u16string> std::hash<std::u32string> std::hash<std::wstring> (C++11) (C++11) (C++11) (C++11)

hash support for strings (class template specialization)