Classe de CStringT

Artigo
02/25/2013

Esta classe representa um objeto de CStringT .

template< typename BaseType, class StringTraits >
class CStringT : 
public CSimpleStringT<   BaseType,   _CSTRING_IMPL_::_MFCDLLTraitsCheck<      BaseType,      StringTraits   >   ::c_bIsMFCDLLTraits>

Parâmetros

BaseType
O tipo da classe de caractere de cadeia de caracteres.Pode ser um dos seguintes:
- char (para cadeias de caracteres ANSI).
- wchar_t (para cadeias de caracteres Unicode).
- ParaTCHAR (ANSI e cadeias de caracteres Unicode).
StringTraits
Determina se o suporte a biblioteca common language runtime (CRT) de As necessidades da classe de cadeia de caracteres e onde os recursos de cadeia de caracteres estão localizados.Pode ser um dos seguintes:
- Wchar_t de strtraitatl< | char | TCHAR de chtraitscrt<, wchar_t | char | TCHAR > >
  
  A classe requer suporte e as pesquisas de CRT para cadeias de caracteres de recurso no módulo especificado por m_hInstResource (um membro da classe do módulo do aplicativo).
- Wchar_t de strtraitatl< | char | TCHAR de chtraitsos<, wchar_t | char | TCHAR > >
  
  A classe não requer suporte e as pesquisas de CRT para cadeias de caracteres de recurso no módulo especificado por m_hInstResource (um membro da classe do módulo do aplicativo).
- Wchar_t de strtraitmfc< | char | TCHAR de chtraitscrt<, wchar_t | char | TCHAR > >
  
  A classe requer suporte e as pesquisas de CRT para cadeias de caracteres de recurso usando o algoritmo de pesquisa MFC do padrão.
- Wchar_t de strtraitmfc< | char | TCHAR de chtraitsos<, wchar_t | char | TCHAR > >
  
  A classe não requer suporte e as pesquisas de CRT para cadeias de caracteres de recurso usando o algoritmo de pesquisa MFC do padrão.

Membros

Construtores public

Nome	Descrição
CStringT::CStringT	Constrói um objeto de CStringT de várias maneiras.
CStringT::~CStringT	For um objeto de CStringT .

Métodos públicos

Nome	Descrição
CStringT::AllocSysString	Atribui BSTR de dados de CStringT .
CStringT::AnsiToOem	Faz uma conversão no lugar do conjunto de caracteres ANSI ao conjunto de caracteres de OEM.
CStringT::AppendFormat	Appends formatada de dados a um objeto existente de CStringT .
CStringT::Collate	Compara duas cadeias de caracteres (diferencia maiúsculas de minúsculas, informações específicas do usa).
CStringT::CollateNoCase	Compara duas cadeias de caracteres (sem diferenciação de maiúsculas e minúsculas, informações específicas do usa).
CStringT::Compare	Compara duas cadeias de caracteres (diferencia maiúsculas de minúsculas).
CStringT::CompareNoCase	Compara duas cadeias de caracteres (sem diferenciação de maiúsculas e minúsculas).
CStringT::Delete	Exclui um caractere ou mais caracteres de uma cadeia de caracteres.
CStringT::Find	Localiza um caractere ou uma subcadeia de caracteres em uma cadeia de caracteres maior.
CStringT::FindOneOf	Localiza o primeiro caractere correspondente de um dataset.
CStringT::Format	Formata a cadeia de caracteres como sprintf faz.
CStringT::FormatMessage	Formata uma cadeia de mensagem.
CStringT::FormatMessageV	Formata uma cadeia de mensagem usando uma lista de argumentos variável.
CStringT::FormatV	Formata a cadeia de caracteres usando uma lista variável de argumentos.
CStringT::GetEnvironmentVariable	Defina a cadeia de caracteres ao valor da variável de ambiente especificada.
CStringT::Insert	Insere um único caractere ou uma subcadeia de caracteres no índice especificado dentro da cadeia de caracteres.
CStringT::Left	Em a parte superior esquerda de uma cadeia de caracteres.
CStringT::LoadString	Carrega um objeto existente de CStringT de um recurso do windows.
CStringT::MakeLower	Converte todos os caracteres na cadeia de caracteres para caracteres maiúsculos.
CStringT::MakeReverse	Inverte a cadeia de caracteres.
CStringT::MakeUpper	Converte todos os caracteres na cadeia de caracteres para caracteres maiúsculos.
CStringT::Mid	Em a parte do meio de uma cadeia de caracteres.
CStringT::OemToAnsi	Faz uma conversão no lugar do conjunto de caracteres de OEM ao conjunto de caracteres ANSI.
CStringT::Remove	Removes indicou caracteres de uma cadeia de caracteres.
CStringT::Replace	Replaces indicou caracteres com outros caracteres.
CStringT::ReverseFind	Localiza um caractere dentro de uma cadeia de caracteres maior; parte do final.
CStringT::Right	Em a parte direita de uma cadeia de caracteres.
CStringT::SetSysString	Define um objeto existente de BSTR com dados de um objeto de CStringT .
CStringT::SpanExcluding	Extrai os caracteres de uma cadeia de caracteres, começando com o primeiro caractere, que não estão no conjunto de caracteres identificados por pszCharSet.
CStringT::SpanIncluding	Extrai uma subcadeia de caracteres que contém somente os caracteres em um dataset.
CStringT::Tokenize	Tokens especificados extratos em uma cadeia de caracteres de destino.
CStringT::Trim	Corta todos os caracteres à esquerda e direita de espaço em branco de cadeia de caracteres.
CStringT::TrimLeft	Guarnições que levam caracteres de espaço em branco de cadeia de caracteres.
CStringT::TrimRight	Guarnições que arraste caracteres de espaço em branco de cadeia de caracteres.

Operadores

CStringT::operator =	Atribuir um novo valor a um objeto de CStringT .
CStringT::operator +	Concatena duas cadeias de caracteres ou um caractere e uma cadeia de caracteres.
CStringT::operator +=	Concatena uma nova cadeia de caracteres ao final de uma cadeia de caracteres existente.
== De CStringT::operator	Determina se duas cadeias de caracteres são logicamente iguais.
CStringT::operator! =	Determina se duas cadeias de caracteres não são logicamente iguais.
CStringT::operator <	Determina se a cadeia de caracteres no lado esquerdo do operador é menor do que a cadeia de caracteres no lado direito.
CStringT::operator >	Determina se a cadeia de caracteres no lado esquerdo do operador é maior do que a cadeia de caracteres no lado direito.
<= De CStringT::operator	Determina se a cadeia de caracteres no lado esquerdo do operador é menor ou igual a cadeia de caracteres no lado direito.
>= De CStringT::operator	Determina se a cadeia de caracteres no lado esquerdo do operador é maior ou igual a cadeia de caracteres no lado direito.

Comentários

CStringT herda de classe de CSimpleStringT.Os recursos avançados, como a manipulação de caractere, classificação, e procurando, são implementados por CStringT.

Observação
Os objetos deCStringT são capazes de lançar exceções.Isso ocorre quando um objeto de CStringT fora de memória por alguma razão.

Um objeto de CStringT consiste em uma seqüência de caracteres de comprimento variável de caracteres.CStringT fornece funções e operadores que usam sintaxe semelhante a de básico.Concatenação e operadores de comparação, juntamente com gerenciamento de memória, simplificado tornam mais fácil de usar objetos CStringT de matrizes de caracteres comuns.

Observação
Embora seja possível criar instâncias de CStringT que contenham caracteres nulos inseridos, recomendamos contra ele.Os métodos e os operadores de chamada em objetos de CStringT que contenham caracteres nulos inseridos podem produzir resultados indesejados.

Usando combinações diferentes dos parâmetros de BaseType e de StringTraits , objetos podem vir de CStringT nos seguintes tipos, que são foram predefinidos pelas bibliotecas de ATL.

Se ele usando em um aplicativo de ATL:

CString, CStringA, e CStringW são exportados de DLL MFC (MFC90.DLL), nunca de DLL do usuário.Isso é feito para impedir que CStringT multiplicar é definido.

Observação
Se você encontrou erros de vinculador exportar CString- classe derivada de uma DLL de extensão MFC no Visual C++ .NET 2002 e aplicada a alternativa conforme descrito no artigo de Base de Dados de Conhecimento, “vinculando erros quando você importar classes Derivadas CString-” (Q309801), você deve remover o código de solução alternativa, porque isso foi corrigido no Visual C++ .NET 2003.Você pode localizar artigos de Base de Dados de Conhecimento da Biblioteca MSDN em um CD-ROM https://support.microsoft.com/supportou.

Se você encontrou erros de vinculador exportar CString- classe derivada de uma DLL de extensão MFC no Visual C++ .NET 2002 e aplicada a alternativa conforme descrito no artigo de Base de Dados de Conhecimento, “vinculando erros quando você importar classes Derivadas CString-” (Q309801), você deve remover o código de solução alternativa, porque isso foi corrigido no Visual C++ .NET 2003.Você pode localizar artigos de Base de Dados de Conhecimento da Biblioteca MSDN em um CD-ROM https://support.microsoft.com/supportou.

Os seguintes tipos de cadeias de caracteres estão disponíveis em aplicativos baseados MFC-:

Tipo de CStringT	Declaração
CStringA	Uma cadeia de caracteres de tipo de caractere ANSI com suporte de CRT.
CStringW	Uma cadeia de caracteres de tipo de caracteres Unicode com suporte de CRT.
CString	ANSI e tipos de caractere Unicode com suporte de CRT.

Os seguintes tipos de cadeias de caracteres estão disponíveis em projetos ATL_CSTRING_NO_CRT onde ela está definida:

Tipo de CStringT	Declaração
CAtlStringA	Uma cadeia de caracteres de tipo de caractere ANSI sem suporte de CRT.
CAtlStringW	Uma cadeia de caracteres de tipo de caracteres Unicode sem suporte de CRT.
CAtlString	ANSI e tipos de caractere Unicode sem suporte de CRT.

Os seguintes tipos de cadeias de caracteres estão disponíveis em projetos ATL_CSTRING_NO_CRT onde não é definida:

Tipo de CStringT	Declaração
CAtlStringA	Uma cadeia de caracteres de tipo de caractere ANSI com suporte de CRT.
CAtlStringW	Uma cadeia de caracteres de tipo de caracteres Unicode com suporte de CRT.
CAtlString	ANSI e tipos de caractere Unicode com suporte de CRT.

Os objetos deCString também têm as seguintes características:

Os objetos deCStringT pode crescer como resultado de operações de concatenação.
Os objetos deCStringT seguem a semântica de “valor”. Pense em um objeto de CStringT como uma cadeia de caracteres real, não como um ponteiro para uma cadeia de caracteres.
Você pode substituir livremente entre objetos de CStringT para argumentos de função de PCXSTR .
Gerenciamento de memória personalizado para buffers de cadeia de caracteres.Para obter mais informações, consulte gerenciamento de memória e CStringT.

CStringT tipos predefinidos

Porque CStringT usa um argumento de modelo para definir o tipo de caracteres (ou) wchar_t charsuportados, tipos de parâmetro do método pode ser complicado às vezes.Para simplificar esse problema, um conjunto de tipos predefinidos é definido e usado durante a classe de CStringT .A tabela a seguir lista os tipos:

Nome	Descrição
XCHAR	Um único caractere ( wchar_t ou char) com o mesmo tipo de caractere que o objeto de CStringT .
YCHAR	Um único caractere ( wchar_t ou char) com o tipo de caractere oposto como o objeto de CStringT .
PXSTR	Um ponteiro para uma cadeia de caracteres ( wchar_t ou char) com o mesmo tipo de caractere que o objeto de CStringT .
PYSTR	Um ponteiro para uma cadeia de caracteres ( wchar_t ou char) com o tipo de caractere oposto como o objeto de CStringT .
PCXSTR	Um ponteiro para uma cadeia de caracteres de const ( wchar_t ou char) com o mesmo tipo de caractere que o objeto de CStringT .
PCYSTR	Um ponteiro para uma cadeia de caracteres de const ( wchar_t ou char) com o tipo de caractere oposto como o objeto de CStringT .

Observação
O código que os métodos indocumentados anteriormente usados de CString (como AssignCopy) devem ser substituídos pelo código que usa os seguintes métodos documentados de CStringT (como GetBuffer ou ReleaseBuffer).Esses métodos são herdadas de CSimpleStringT.

Hierarquia de herança

CSimpleStringT

CStringT

Requisitos

Header	Para uso
cstringt.h	Objetos de cadeia de caracteres MFC - somente
atlstr.h	Objetos de cadeia de caracteres não MFC

Consulte também

Referência

Gráfico de hierarquia

Classe de CSimpleStringT

Outros recursos

ATL/MFC compartilhasse classes

Compartilhar via