basic_string Class

As seqüências controladas por um objeto do modelo classe basic_string são a classe de seqüência de caracteres de C++ padrão e geralmente são conhecidas como cadeias de caracteres, mas eles não devem ser confundidos com as seqüências de terminação nula C-usadas em toda a biblioteca C++ padrão.A classe string é um recipiente que permite o uso de seqüências de caracteres como tipos normais, como, por exemplo, usando as operações de comparação e concatenação, iteradores e algoritmos da STL e copiando e atribuição de alocador de classe de memória gerenciada.

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 ser armazenados na seqüência de caracteres.A biblioteca C++ padrão fornece duas especializações dessa classe de modelo, com as definições de tipo seqüência, para elementos do tipo char, e wstring, para elementos do tipo wchar_t.

• Traits
  Várias propriedades importantes do CharType elementos em uma especialização de basic_string são descritos pela classe características.

• Allocator
  O tipo que representa o objeto alocador armazenados que encapsula os detalhes sobre a seqüência alocação e desalocação de memória.O valor padrão é alocador*<Type>.*

Muitas funções de membro exigem uma seqüência de operando de elementos.Você pode especificar como uma seqüência operando várias maneiras.

Elemento	Descrição
_Ch	Um elemento com o valor de caractere _Ch.
_Count, _Ch	Uma repetição de _Count elementos com valor _Ch.
_Ptr	Uma seqüência terminada por caractere nulo, como uma seqüência de caracteres c com um CharType do tipo char, começando em _Ptr (que não deve ser um ponteiro nulo), onde o elemento de terminação é o valor value_type e não é parte da seqüência do operando.
_Ptr, Count	Uma seqüência de _Count elementos começando no _Ptr.
_Str	A seqüência especificada por um objeto basic_string.
_Str, off, Count	A subseqüência de caracteres do objeto basic_string _Str com até _Count elementos (ou até o final da seqüência de caracteres, que vier primeiro) começando na posição off.
_First, _Last	Uma seqüência de elementos, delimitados pelos iteradores _First e _Last, no intervalo [_First, _Last), que podem se sobrepor a seqüência controlada pelo objeto string cuja função de membro está sendo chamada.

Se um argumento de posição (como _Off) está além do fim da seqüência de caracteres em uma chamada para um basic_string função de membro, a função relata um erro de fora do intervalo, lançando um objeto do tipo out_of_range classe.

Se uma função é solicitada a gerar uma seqüência de mais de max_size elementos, a função relata um erro de comprimento lançando um objeto do tipo length_error classe.

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

Construtores

basic_string

Constrói uma seqüência de caracteres é vazio ou inicializado por caracteres específicos ou isto é uma cópia de todos ou parte de outro objeto de seqüência ou seqüência de C.

Typedefs

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

Funções de membro

acrescentar	Adiciona caracteres ao final de uma seqüência de caracteres.
atribuir	Atribui novos valores de caractere para o conteúdo de uma seqüência de caracteres.
em	Retorna uma referência ao elemento em um local especificado na seqüência de caracteres.
Voltar
início	Retorna um iterador endereçamento do primeiro elemento na seqüência.
c_str	Converte o conteúdo de uma seqüência de caracteres como uma cadeia terminada com nulo, C-estilo.
capacidade	Retorna o maior número de elementos que podem ser armazenados em uma seqüência de caracteres sem aumentar alocação de memória da seqüência de caracteres.
cbegin	Retorna um iterador const endereçamento do primeiro elemento na seqüência.
cend	Retorna um iterador const que aborda o local subseqüente do último elemento em uma seqüência.
Limpar	Apaga todos os elementos de uma seqüência de caracteres.
Comparar	Compara uma seqüência com uma seqüência de caracteres especificada para determinar se duas seqüências são iguais ou se uma é lexicograficamente menor do que o outro.
cópia	Copia no máximo um número especificado de caracteres de uma posição indexada em uma seqüência de caracteres de origem para uma matriz de caracteres de destino.Preterido.Use basic_string::_Copy_s em vez disso.
crbegin	Retorna um iterador const que aborda o primeiro elemento em uma seqüência inversa.
crend	Retorna um iterador const que aborda o local subseqüente do último elemento em uma seqüência inversa.
_Copy_s	Copia no máximo um número especificado de caracteres de uma posição indexada em uma seqüência de caracteres de origem para uma matriz de caracteres de destino.
dados	Converte o conteúdo de uma seqüência de caracteres em uma matriz de caracteres.
vazio	Testa se a seqüência de caracteres contém caracteres.
fim	Retorna um iterador que aborda o local subseqüente do último elemento em uma seqüência.
apagar	Remove um elemento ou um intervalo de elementos em uma seqüência de caracteres de uma posição especificada.
localização	Procura uma seqüência de caracteres em uma direção direta para a primeira ocorrência de uma substring que corresponde a uma seqüência de caracteres especificada.
find_first_not_of	Pesquisas por meio de uma seqüência de caracteres para o primeiro caractere que não é qualquer elemento de uma seqüência de caracteres especificada.
find_first_of	Pesquisas por meio de uma seqüência de caracteres para o primeiro caractere que corresponde a qualquer elemento de uma seqüência de caracteres especificada.
find_last_not_of	Pesquisas por meio de uma seqüência de caracteres para o último caractere não é qualquer elemento de uma seqüência de caracteres especificada.
find_last_of	Pesquisas por meio de uma seqüência de caracteres para o último caractere é um elemento de uma seqüência de caracteres especificada.
frontal	Retorna uma referência ao primeiro elemento em uma seqüência.
get_allocator	Retorna uma cópia do allocator objeto usado para construir a seqüência.
Inserir	Insere um elemento ou um número de elementos ou um intervalo de elementos na seqüência de caracteres em uma posição especificada.
comprimento	Retorna o número atual de elementos em uma seqüência.
max_size	Retorna o número máximo de caracteres de que uma seqüência de caracteres pode conter.
pop_back	Apaga o último elemento da seqüência de caracteres.
push_back	Adiciona um elemento ao final da seqüência de caracteres.
rbegin	Retorna um iterador para o primeiro elemento em uma seqüência inversa.
rend	Retorna um iterador que pontos apenas além do último elemento em uma seqüência inversa.
Substituir	Substitui elementos em uma seqüência de caracteres em uma posição especificada por caracteres especificados ou copiados de outros intervalos ou seqüências de caracteres ou seqüências de C.
reservar	Define a capacidade da cadeia de caracteres para um número pelo menos tão grande como um número especificado.
redimensionar	Especifica um novo tamanho de uma seqüência de caracteres, acrescentando ou apagar elementos conforme necessário.
rfind	Procura uma seqüência de caracteres em uma direção para trás para a primeira ocorrência de uma substring que corresponde a uma seqüência de caracteres especificada.
shrink_to_fit	Descarta o excesso de capacidade da cadeia de caracteres.
tamanho	Retorna o número atual de elementos em uma seqüência.
substr	Copia uma subseqüência de no máximo um número de caracteres de uma string que começa em uma posição especificada.
troca	Troca o conteúdo de duas seqüências de caracteres.

Operadores

+ = operador	Acrescenta uma seqüência de caracteres.
operador =	Atribui novos valores de caractere para o conteúdo de uma seqüência de caracteres.
operador]	Fornece uma referência para o caractere com um índice especificado em uma seqüência.

Requisitos

Cabeçalho: <string>

Namespace: std

Consulte também

Referência

Segurança do thread na biblioteca C++ padrão

Outros recursos

os membros do basic_string

<string> Membros