Classe CHString
[A classe CHString faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas em todos os novos desenvolvimentos.]
A tabela a seguir lista os métodos CHString.
Membros
A classe CHString tem estes tipos de membros:
Construtores
A classe CHString tem estes construtores.
| Construtor | Descrição |
|---|---|
| CHString | Constrói cadeias de caracteres CHString de várias maneiras. |
Métodos
A classe CHString tem estes métodos.
| Método | Descrição |
|---|---|
| AllocSysString | Aloca um BSTR de dados CHString. |
| Collate | Compara duas cadeias de caracteres (diferencia maiúsculas de minúsculas; usa informações específicas da localidade). |
| Comparar | Compara duas cadeias de caracteres (diferencia maiúsculas de minúsculas). |
| CompareNoCase | Compara duas cadeias de caracteres (não diferencia maiúsculas de minúsculas). |
| Vazio | Força uma cadeia de caracteres a ter comprimento 0 (zero). |
| Find | Sobrecarregado. Localiza um caractere ou substring dentro de uma cadeia de caracteres maior. |
| FindOneOf | Localiza o primeiro caractere correspondente de um conjunto. |
| Formatar | Sobrecarregado. Formata a cadeia de caracteres como sprintf faz. |
| FormatMessageW | Sobrecarregado. Formata uma cadeia de caracteres de mensagem. |
| FormatV | Formata a cadeia de caracteres como vsprintf faz. |
| FreeExtra | Remove qualquer sobrecarga dessa cadeia de caracteres liberando qualquer memória extra alocada anteriormente para a cadeia de caracteres. |
| GetAllocLength | Retorna o tamanho do buffer da cadeia de caracteres. |
| GetAt | Sobrecarregado. Retorna o caractere em uma determinada posição. |
| GetBuffer | Retorna um ponteiro para os caracteres na cadeia de caracteres CHString. |
| GetBufferSetLength | Retorna um ponteiro para os caracteres na cadeia de caracteres CHString, truncando no comprimento especificado. |
| GetData | Retorna um ponteiro para os dados na cadeia de caracteres CHString. |
| GetLength | Retorna o número de caracteres Unicode na cadeia de caracteres CHString. |
| IsEmpty | Testa se uma cadeia de caracteres CHString não contém caracteres. |
| Left | Extrai a parte esquerda de uma cadeia de caracteres (como a função LEFT$ Básica). |
| LoadStringW | Carrega uma cadeia de caracteres CHString existente de um arquivo de recurso. |
| LockBuffer | Desabilita a contagem de referências e protege a cadeia de caracteres no buffer. |
| MakeLower | Converte todos os caracteres nessa cadeia de caracteres em caracteres minúsculos. |
| MakeReverse | Inverte os caracteres nessa cadeia de caracteres. |
| MakeUpper | Converte todos os caracteres nessa cadeia de caracteres em caracteres maiúsculos. |
| Mid | Sobrecarregado. Extrai a parte intermediária de uma cadeia de caracteres (como a função MID$ Básica). |
| ReleaseBuffer | Libera o controle do buffer retornado por GetBuffer. |
| ReverseFind | Localiza um caractere dentro de uma cadeia de caracteres maior; começa do final. |
| Right | Extrai a parte direita de uma cadeia de caracteres (como a função RIGHT$ Básica). |
| SetAt | Define um caractere em uma determinada posição. |
| SpanExcluding | Extrai uma substring que contém apenas os caracteres em um conjunto. |
| SpanIncluding | Extrai uma substring que contém apenas os caracteres em um conjunto. |
| TrimLeft | Remove os caracteres de espaço em branco à esquerda de uma cadeia de caracteres. |
| TrimRight | Remove todos os caracteres de espaço em branco à direita de uma cadeia de caracteres. |
| UnlockBuffer | Habilita a contagem de referências e libera a cadeia de caracteres no buffer. |
Operadores
The **CHString** class has these operators.
| Operador | Descrição |
|---|---|
| operator != (CHString, CHString) | Compara dois CHStrings quanto à desigualdade. |
| operator != (CHString, LPCWSTR) | Compara um CHString com um LPCWSTR quanto à desigualdade. |
| operator [] | Retorna o caractere em uma determinada posição substituição do operador para GetAt. |
| operator + | Concatena duas cadeias de caracteres e retorna uma nova cadeia de caracteres. |
| operator += | Concatena uma nova cadeia de caracteres até o final de uma cadeia de caracteres existente. |
| operator < (CHString, LPCWSTR) | Compara um CHString com um LPCWSTR. |
| operator < (CHString, CHString) | Compara duas CHStrings. |
| operator <= (CHString, CHString) | Compara duas CHStrings. |
| operator <= (CHString, LPCWSTR) | Compara um CHString com um LPCWSTR. |
| operator = | Atribui um novo valor a uma cadeia de caracteres CHString. |
| operator == (CHString, CHString) | Compara dois CHStrings quanto à igualdade. |
| operator == (CHString, LPCWSTR) | Compara um CHString com um LPCWSTR quanto à igualdade. |
| operator > (CHString, CHString) | Compara duas CHStrings. |
| operator > (CHString, LPCWSTR) | Compara um CHString com um LPCWSTR. |
| operator >= (CHString, CHString) | Compara duas CHStrings. |
| operator >= (CHString, LPCWSTR) | Compara um CHString com um LPCWSTR. |
| operator LPCWSTR | Acessa diretamente caracteres armazenados em uma cadeia de caracteres CHString como uma cadeia de caracteres no estilo C. |
Comentários
O destruidor da classe é CHString::~CHString.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|