Classe basic_string

As sequências controladas por um objeto da classe de modelos basic_string são a classe de cadeia C ++ Padrão e geralmente são conhecidas como cadeias de caracteres, mas não devem ser confundidas com as cadeias de estilo C de terminação nula usadas ​​em toda a biblioteca C ++ Padrão. A cadeia de caracteres C++ Padrão é um contêiner que permite o uso de cadeias de caracteres como tipos de normais, como operações de comparação e concatenação, iteradores, algoritmos STL e cópia e atribuição com memória gerenciada por alocador de classe. Se você precisar converter uma cadeia de caracteres C++ Padrão em uma cadeia de caracteres de estilo C de terminação nula, use o membro basic_string::c_str.

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

Parâmetros

• CharType
  O tipo de dados de um único caractere a ser armazenado na cadeia de caracteres. A biblioteca C ++ Padrão oferece especializações desta classe de modelo, com a cadeia de definições de tipo para elementos do tipo char, wstring, para wchar_t, u16string para char16_t, e u32string para char32_t.

• Traits
  Várias propriedades importantes dos elementos CharType em uma especialização basic_string são descritas pela classe Traits. O valor padrão é char_traits<CharType>.

• Allocator
  O tipo que representa o objeto alocador armazenado que encapsula detalhes sobre a alocação e desalocação de memória da cadeia de caracteres. O valor padrão é allocator<CharType>.

Construtores

basic_string

Cria uma cadeia de caracteres vazia ou iniciada por caracteres específicos ou que seja uma cópia de todos ou parte de algum outro objeto da cadeia de caracteres ou da cadeia de caracteres C.

Typedefs

allocator_type	Um tipo que representa a classe allocator para um objeto da cadeia de caracteres.
const_iterator	Um tipo que fornece um iterador de acesso aleatório que pode acessar e ler um elemento const na cadeia de caracteres.
const_pointer	Um tipo que fornece um ponteiro para um elemento const em uma cadeia de caracteres.
const_reference	Um tipo que fornece uma referência para um elemento const armazenado em um cadeia para leitura e execução de operações const.
const_reverse_iterator	Um tipo que fornece um iterador de acesso aleatório que pode ler qualquer elemento const na cadeia de caracteres.
difference_type	Um tipo que fornece a diferença entre dois iteradores que se referem a elementos na mesma cadeia.
iterator	Um tipo que fornece um iterador de acesso aleatório que pode ler ou modificar qualquer elemento em uma cadeia de caracteres.
npos	Um valor integral não assinado inicializado como – 1 que indica "não encontrado" ou "todos os demais caracteres" quando uma função de pesquisa falha.
pointer	Um tipo que fornece um ponteiro para um elemento de caracteres em uma matriz de cadeia de caracteres ou caractere.
reference	Um tipo que fornece uma referência a um elemento armazenado em uma cadeia de caracteres.
reverse_iterator	Um tipo que fornece um iterador de acesso aleatório que pode ler ou modificar qualquer elemento em uma cadeia de caracteres invertida.
size_type	Um tipo integral não assinado para o número de elementos em uma cadeia.
traits_type	Um tipo para as características dos elementos armazenados em uma cadeia de caracteres.
value_type	Um tipo que representa o tipo de caracteres armazenados em uma cadeia de caracteres.

Funções membro

acrescentar	Acrescenta caracteres ao final de uma cadeia de caracteres.
assign	Atribui novos valores de caracteres ao conteúdo de uma cadeia de caracteres.
at	Retorna uma referência ao elemento em um local especificado na cadeia de caracteres.
back
begin	Retorna um iterador que trata o primeiro elemento na cadeia de caracteres.
c_str	Converte o conteúdo de uma cadeia de caracteres em uma cadeia de estilo C, com terminação nula.
capacity	Retorna o maior número de elementos que podem ser armazenados em uma cadeia de caracteres sem aumentar a alocação de memória da cadeia.
cbegin	Retorna um iterador const que trata o primeiro elemento na cadeia.
cend	Retorna um iterador const que trata o local após o último elemento em uma cadeia.
clear	Apaga todos os elementos de uma cadeia de caracteres.
compare	Compara uma cadeia de caracteres com uma cadeia especificada para determinar se duas cadeias são iguais ou se uma é lexicograficamente menor do que a outra.
copy	Copia, no máximo, um número específico de caracteres de uma posição indexada em uma cadeia de caracteres de origem em um conjunto de caracteres de destino. Preterido. Use basic_string::_Copy_s em seu lugar.
crbegin	Retorna um iterador const que trata o primeiro elemento em uma cadeia de caracteres invertida.
crend	Retorna um iterador const que trata o local após o último elemento em uma cadeia invertida.
_Copy_s	Copia, no máximo, um número específico de caracteres de uma posição indexada em uma cadeia de caracteres de origem em um conjunto de caracteres de destino.
dados	Converte o conteúdo de uma cadeia de caracteres em uma matriz de caracteres.
empty	Testa se a cadeia de caracteres contém caracteres.
end	Retorna um iterador que trata o local após o último elemento em uma cadeia de caracteres.
erase	Remove um elemento ou um intervalo de elementos em uma cadeia de caracteres de uma posição especificada.
find	Pesquisa, para frente, em uma cadeia de caracteres, a primeira ocorrência de uma subcadeia que corresponde a uma sequência de caracteres especificada.
find_first_not_of	Pesquisa, em uma cadeia de caracteres, o primeiro caractere que não seja um elemento de uma cadeia de caracteres especificada.
find_first_of	Pesquisa, em uma cadeia de caracteres, o primeiro caractere que corresponda a qualquer elemento de uma cadeia de caracteres especificada.
find_last_not_of	Pesquisa, em uma cadeia de caracteres, o último caractere que não seja um elemento de uma cadeia de caracteres especificada.
find_last_of	Pesquisa, em uma cadeia de caracteres, o último caractere que seja um elemento de uma cadeia de caracteres especificada.
front	Retorna uma referência ao primeiro elemento em uma cadeia de caracteres.
get_allocator	Retorna uma cópia do objeto allocator usado para construir a cadeia.
insert	Insere um elemento ou um número de elementos ou um intervalo de elementos na cadeia de caracteres na posição especificada.
length	Retorna o número de elementos em uma cadeia de caracteres.
max_size	Retorna o número máximo de caracteres que uma cadeia de caracteres pode conter.
pop_back	Apaga o último elemento da cadeia de caracteres.
push_back	Adiciona um elemento ao final de uma cadeia de caracteres.
rbegin	Retorna um iterador ao primeiro elemento em uma cadeia invertida.
rend	Retorna um iterador que aponta além do último elemento em uma cadeia de caracteres invertida.
replace	Substitui elementos em uma cadeia de caractere em uma posição especificada por caracteres especificados ou copiados de outros intervalos de cadeia de caracteres ou cadeias C.
reserve	Define a capacidade da cadeia de caracteres para um número pelo menos tão grande quanto um número especificado.
resize	Especifica um novo tamanho para uma cadeia de caracteres, acrescentando ou apagando elementos conforme necessário.
rfind	Pesquisa, para trás, em uma cadeia de caracteres, a primeira ocorrência de uma subcadeia que corresponde a uma sequência de caracteres especificada.
shrink_to_fit	Descarta a capacidade excedente da cadeia de caracteres.
size	Retorna o número de elementos em uma cadeia de caracteres.
substr	Copia uma subcadeia de, no máximo, um número de caracteres, de uma cadeia com início em uma posição especificada.
swap	Troca o conteúdo das duas cadeias de caracteres.

Operadores

operator+=	Acrescenta caracteres a uma cadeia de caracteres.
operator=	Atribui novos valores de caracteres ao conteúdo de uma cadeia de caracteres.
operator[]	Fornece uma referência ao caractere com um índice especificado em uma cadeia de caracteres.

Comentários

Se uma função for solicitada a gerar uma sequência mais longa do que os elementos max_size, a função relatará um erro de duração utilizando um objeto do tipo length_error.

Referências, ponteiros e iteradores que designam elementos da sequência controlada podem se tornar inválidos após qualquer chamada de uma função que altera a sequência controlada ou após a primeira chamada de função de um membro não const.

Requisitos

Cabeçalho: <string>

Namespace: std

Consulte também

Referência

<string>

Segurança de threads na Biblioteca Padrão C++