Compartilhar via

Classe de CStringT

  • Artigo

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.

Dica

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.

Dica

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.

Dica

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_tcharsuportados, 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 .

Dica

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 da hierarquia

Classe de CSimpleStringT

Outros recursos

ATL/MFC compartilhasse classes