basic_string Class

아티클
03/15/2013

개체의 템플릿 클래스 basic_string에 의해 제어 되는 시퀀스는 표준 C++ 문자열 클래스 이며 일반적으로, 문자열 이라고 하지만는 null로 끝나는 C-C++ 표준 라이브러리 전체에서 사용 되는 문자열과 함께 혼동 하지 마십시오.String 클래스 사용 하는 문자열 비교 및 연결 작업, 반복기 및 STL 알고리즘을 사용 하 여 복사 하는 것과 같은 일반적인 형식으로 사용 하는 컨테이너 이며 관리 되는 메모리 할당 클래스 할당자를.

template <
   class CharType,
   class Traits=char_traits<CharType>, 
   class Allocator=allocator<CharType> 
>
class basic_string

매개 변수

CharType
데이터 형식 문자열에 저장 되는 단일 문자입니다.이 형식 정의를 템플릿 클래스의 두 가지 특수화 표준 C++ 라이브러리를 제공 합니다. 문자열, 형식의 요소에 대 한 char, 및 wstring, 형식의 요소에 대 한 wchar_t.
Traits
여러 가지 중요 한 속성의 CharType 클래스에 의해 특수화 basic_string에서에서 요소 설명 되어 성분.
Allocator
문자열의 할당 및 메모리 할당 취소 하는 방법에 대 한 세부 정보를 캡슐화 하는 저장 된 할당자 개체를 나타내는 형식입니다.기본값은 할당자*<Type>.*

많은 멤버 함수는 피연산자 시퀀스의 요소가 필요합니다.이러한 된 피연산자 시퀀스 여러 가지 방법으로 지정할 수 있습니다.

요소	설명
_Ch	문자 값을 갖는 하나의 요소 _Ch.
_Count, _Ch	반복 되는 _Count 각 요소 값을 가진 _Ch.
_Ptr	Null 종료 시퀀스는 C 문자열 같은는 CharType 형식의 char시작 _Ptr (는 널 포인터 아니어야 합니다), 여기서 종료 요소가 값입니다 value_type 및 피연산자 시퀀스의 일부가 아닙니다.
_Ptr, _Count	일련의 _Count 요소부터 _Ptr.
_Str	Basic_string 개체에서 지정 된 시퀀스입니다.
_Str, _Off, _Count	Basic_string 개체의 부분 문자열 _Str 와 최대 _Count 요소를 통해 문자열의 끝을 지나면 위치부터 _Off.
_First, _Last	반복기가 구분 된 요소의 시퀀스를 _First 및 _Last, 범위의 [_First, _Last)에 string 개체에서 해당 멤버 함수 호출 제어 시퀀스 겹칠 수 있습니다.

위치 인수 하는 경우 (같은 _Off)를 호출할 때 문자열의 끝입니다를 basic_string 멤버 함수는 함수 보고 범위를 벗어났다는 오류 형식의 개체를 throw 하 여 out_of_range 클래스.

함수 보다 긴 시퀀스를 생성 해야 하면 max_size 요소를 함수 보고 길이 오류 형식의 개체를 throw 하 여 클래스의 length_error.

참조, 포인터 및 제어 되는 시퀀스의 요소를 지정 하는 반복기 잘못 될 수 있습니다 제어 되는 시퀀스를 변경 하는 함수를 처음 호출할 때 아닌 한 후 또는-const 멤버 함수입니다.

생성자

basic_string

빈 이거나 특정 문자 또는 즉의 모든 복사본 또는 다른 string 개체의 부분 초기화 C 문자열 또는 문자열을 만듭니다.

형식 정의

allocator_type	나타내는 형식에 allocator 문자열 개체에 대 한 클래스입니다.
const_iterator	임의 액세스 반복기를 제공 하는 형식 액세스 읽기 및 수는 const 문자열에서 요소입니다.
const_pointer	에 대 한 포인터를 제공 하는 형식에 const 문자열에서 요소입니다.
const_reference	에 대 한 참조를 제공 하는 형식에 const 를 읽고 수행 하는 문자열에 저장 된 요소 const 작업.
const_reverse_iterator	모든 것을 제공 하는 임의 액세스 반복기는 형식을 읽을 const 문자열에서 요소입니다.
difference_type	동일한 문자열 내에서 요소를 참조 하는 두 반복기 사이의 차이 설명 하는 형식입니다.
반복기	임의 액세스 반복기를 제공 하는 형식 읽기 또는 문자열의 요소를 수정할 수 있습니다.
npos	"모든 남은 자" 또는 "not found" 나타내는 – 1 초기화 부호 없는 정수 값 검색 함수가 실패 한 경우.
pointer	문자 요소를 문자열 또는 문자 배열에 대 한 포인터를 제공 하는 형식입니다.
reference	문자열에 저장 된 요소에 대 한 참조를 제공 하는 형식입니다.
reverse_iterator	읽거나 반전 된 문자열의 요소를 수정 하는 임의 액세스 반복기를 제공 하는 형식입니다.
size_type	문자열에 있는 요소의 수는 부호 없는 정수 계열 형식
traits_type	문자 성분에 대 한 형식 문자열에 저장 된 요소입니다.
value_type	형식 문자열에 저장 되는 문자를 나타내는 형식.

멤버 함수

append	문자열의 끝에 문자를 추가합니다.
assign	문자열 내용에 새 문자 값을 할당합니다.
at	문자열에서 지정 된 위치에 있는 요소에 대 한 참조를 반환합니다.
back
begin	문자열에서 첫 번째 요소의 주소를 지정 하는 반복기를 반환 합니다.
c_str	문자열의 내용을 C 스타일 null로 끝나는 문자열로 변환합니다.
capacity	문자열에 문자열의 메모리 할당을 늘리지 않고도 저장할 수 있는 요소의 최대값을 반환 합니다.
cbegin	Const 문자열에서 첫 번째 요소의 주소를 지정 하는 반복기를 반환 합니다.
cend	문자열의 마지막 요소 다음에 나오는 위치 주소는 const 반복기를 반환 합니다.
clear	문자열의 모든 요소를 지웁니다.
compare	문자열을 두 개의 문자열이 같은지 아니면 하나 보다 다른 사전순 작은지 확인 하는 지정 된 문자열을 비교 합니다.
copy	최대는 지정한 문자 수 만큼은 인덱싱된 위치에서 소스 문자열 대상 문자 배열에 복사합니다.사용되지 않습니다.대신 basic_string::_Copy_s를 사용하십시오.
crbegin	반전된 문자열의 첫 번째 요소를 해결 하는 const 반복기를 반환 합니다.
crend	반전된 문자열의 마지막 요소 다음에 나오는 위치 주소는 const 반복기를 반환 합니다.
_Copy_s	최대는 지정한 문자 수 만큼은 인덱싱된 위치에서 소스 문자열 대상 문자 배열에 복사합니다.
data	문자열의 내용을 문자 배열로 변환합니다.
empty	String에 문자가 들어 있는지 여부를 테스트 합니다.
end	문자열의 마지막 요소 다음에 나오는 위치를 설명 하는 반복기를 반환 합니다.
지우기	문자열에서 지정 된 위치에서 요소 또는 요소 범위를 제거합니다.
find	앞으로 지정 된 문자 시퀀스와 일치 하는 부분 문자열의 처음 나오는 문자열을 검색 합니다.
find_first_not_of	지정된 된 문자열의 모든 요소가 없는 첫 번째 문자는 문자열을 통해 검색 합니다.
find_first_of	지정 된 문자열의 요소와 일치 하는 첫 번째 문자는 문자열을 통해 검색 합니다.
find_last_not_of	지정된 된 문자열의 모든 요소가 없는 마지막 문자는 문자열을 통해 검색 합니다.
find_last_of	요소는 지정 된 문자열의 마지막 문자는 문자열을 통해 검색 합니다.
front	문자열의 첫 번째 요소에 대 한 참조를 반환합니다.
get_allocator	복사본을 반환의 allocator 문자열을 작성 하는 데 사용 되는 개체입니다.
삽입	요소 또는 요소의 숫자 또는 요소 범위의 문자열의 지정 된 위치에 삽입합니다.
length	현재 요소의 문자열을 반환합니다.
max_size	문자가 문자열에 포함 될 수 있습니다 최대 개수를 반환 합니다.
pop_back	문자열의 마지막 요소를 지웁니다.
push_back	문자열의 끝에 요소를 추가합니다.
rbegin	반전된 문자열의 첫 번째 요소에 반복기를 반환합니다.
rend	반전된 문자열의 마지막 요소 바로 뒤를 가리키는 반복기를 반환합니다.
replace	요소를 문자열의 지정 된 위치에 지정한 문자 또는 기타 범위 또는 문자열이 나 C 문자열에서 복사 되는 문자를 바꿉니다.
reserve	문자열의 용량을 최소한 지정 된 수 만큼 좋은 숫자를 설정합니다.
resize	문자열을 추가 하거나, 필요에 따라 요소 지우기에 대 한 새 크기를 지정 합니다.
rfind	뒤쪽의 지정 된 문자 시퀀스와 일치 하는 부분 문자열에서 처음 나오는 문자열을 검색 합니다.
shrink_to_fit	문자열의 과도 한 용량을 무시합니다.
size	현재 요소의 문자열을 반환합니다.
substr	지정 된 위치에서 시작 하는 문자열에서에서 부분 문자열의 최대 문자 수를 복사합니다.
스왑	두 문자열의 내용을 교환 합니다.

연산자

= 연산자	문자열에 문자를 추가합니다.
operator=	문자열 내용에 새 문자 값을 할당합니다.
operator[]	문자열에서 지정 된 인덱스에 있는 문자에 대 한 참조를 제공합니다.

요구 사항

헤더: <string>

네임 스페이스: std

참고 항목

참조

표준 C++ 라이브러리에서 스레드로부터의 안전성

기타 리소스

basic_string 멤버

<string> 멤버

다음을 통해 공유