Partilhar via


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.

syxtdd4f.collapse_all(pt-br,VS.110).gifConstrutores

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.

syxtdd4f.collapse_all(pt-br,VS.110).gifTypedefs

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.

syxtdd4f.collapse_all(pt-br,VS.110).gifFunçõ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.

syxtdd4f.collapse_all(pt-br,VS.110).gifOperadores

+ = 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