CComBSTR - classe

Artigo
02/25/2013

Essa classe é um wrapper para BSTRS.

class CComBSTR

Membros

Construtores public

Nome	Descrição
CComBSTR::CComBSTR	o construtor.
CComBSTR::~CComBSTR	O destrutor.

Métodos públicos

Nome	Descrição
CComBSTR::Append	Acrescenta uma cadeia de caracteres a m_str.
CComBSTR::AppendBSTR	Acrescenta BSTR a m_str.
CComBSTR::AppendBytes	Acrescenta um número de bytes especificado a m_str.
CComBSTR::ArrayToBSTR	Cria BSTR do primeiro caractere de cada elemento no safearray e anexá-la ao objeto de CComBSTR .
CComBSTR::AssignBSTR	Atribui BSTR a m_str.
CComBSTR::Attach	Anexa BSTR ao objeto de CComBSTR .
CComBSTR::BSTRToArray	Cria um safearray unidimensional com base zero, onde cada elemento da matriz é um caractere de objeto de CComBSTR .
CComBSTR::ByteLength	Retorna o comprimento de m_str em bytes.
CComBSTR::Copy	Retorna uma cópia de m_str.
CComBSTR::CopyTo	Retorna uma cópia de m_str através de um parâmetro de [out]
CComBSTR::Detach	Dispara m_str do objeto de CComBSTR .
CComBSTR::Empty	Libera m_str.
CComBSTR::Length	Retorna o comprimento de m_str.
CComBSTR::LoadString	Carrega um recurso de cadeia de caracteres.
CComBSTR::ReadFromStream	Carrega um objeto de BSTR de um fluxo.
CComBSTR::ToLower	Converte a cadeia de caracteres em minúsculas.
CComBSTR::ToUpper	Converte a cadeia de caracteres para maiúsculas.
CComBSTR::WriteToStream	Salva m_str em um fluxo.

Operadores públicos

Nome	Descrição
CComBSTR::operator BSTR	Converte um objeto de CComBSTR a BSTR.
CComBSTR::operator!	Retorna true ou false, dependendo se m_stré NULL.
CComBSTR::operator! =	Compara CComBSTR com uma cadeia de caracteres.
CComBSTR::operator &	Retorna o endereço de m_str.
CComBSTR::operator +=	Acrescenta CComBSTR ao objeto.
CComBSTR::operator <	Compara CComBSTR com uma cadeia de caracteres.
CComBSTR::operator =	Atribui um valor a m_str.
== De CComBSTR::operator	Compara CComBSTR com uma cadeia de caracteres.
CComBSTR::operator >	Compara CComBSTR com uma cadeia de caracteres.

Membros públicos de dados

Nome	Descrição
CComBSTR::m_str	Contém BSTR associado ao objeto de CComBSTR .

Comentários

a classe de CComBSTR é um wrapper para BSTRs, que são cadeias de caracteres comprimento-prefixadas.O comprimento é armazenado como um todo no local da memória que precede dados a cadeia de caracteres.

BSTR NULL- é encerrado após o caractere a contagem o último mas também pode conter caracteres nulos inseridos dentro da cadeia de caracteres.O comprimento da cadeia de caracteres é determinado pelo número de caracteres, não o primeiro caractere nulo.

Observação
A classe de CComBSTR fornece um número de membros (construtores, operadores de atribuição, e operadores de comparação) que leva ANSI ou cadeias de caracteres Unicode como argumentos.As versões ANSI de essas funções são menos eficiente do que suas contrapartes Unicode como cadeias de caracteres Unicode temporário internamente geralmente são criadas.Para eficiência, use as versões Unicode sempre que possível.

A classe de CComBSTR fornece um número de membros (construtores, operadores de atribuição, e operadores de comparação) que leva ANSI ou cadeias de caracteres Unicode como argumentos.As versões ANSI de essas funções são menos eficiente do que suas contrapartes Unicode como cadeias de caracteres Unicode temporário internamente geralmente são criadas.Para eficiência, use as versões Unicode sempre que possível.

Observação
Devido ao comportamento de pesquisa melhor implementada no Visual Studio .NET, o código como bstr = L"String2" + bstr;, que podem ter criado em versões anteriores, em vez de isso deve ser implementado como bstr = CStringW(L"String2") + bstr.

Para obter uma lista de cuidados ao usar CComBSTR, consulte programação com CComBSTR.

Requisitos

Cabeçalho: atlbase.h

Consulte também

Conceitos

Macros de conversão de cadeia de caracteres de ATL e de MFC

Outros recursos

Visão geral da classe de ATL

Compartilhar via