Classe CComBSTR

Article
03/04/2013

Cette classe est un wrapper pour BSTRS.

class CComBSTR

Membres

Constructeurs publics

Nom	Description
CComBSTR::CComBSTR	Constructeur.
CComBSTR::~CComBSTR	Le destructeur.

Méthodes publiques

Nom	Description
CComBSTR::Append	Ajoute une chaîne à m_str.
CComBSTR::AppendBSTR	Ajoute BSTR à m_str.
CComBSTR::AppendBytes	Ajoute un nombre d'octets spécifié à m_str.
CComBSTR::ArrayToBSTR	Crée BSTR du premier caractère de chaque élément dans un safearray et l'attache à l'objet d' CComBSTR .
CComBSTR::AssignBSTR	Assigne BSTR à m_str.
CComBSTR::Attach	Joint BSTR à l'objet d' CComBSTR .
CComBSTR::BSTRToArray	Crée un safearray unidimensionnel de base zéro, où chaque élément du tableau est un caractère de l'objet d' CComBSTR .
CComBSTR::ByteLength	Retourne la longueur d' m_str en octets.
CComBSTR::Copy	Retourne une copie d' m_str.
CComBSTR::CopyTo	Retourne une copie d' m_str via un paramètre de [out]
CComBSTR::Detach	Détache m_str de l'objet d' CComBSTR .
CComBSTR::Empty	Libère m_str.
CComBSTR::Length	Retourne la longueur d' m_str.
CComBSTR::LoadString	Charge une ressource de type chaîne.
CComBSTR::ReadFromStream	Charge un objet d' BSTR d'un flux.
CComBSTR::ToLower	Convertit la chaîne en minuscules.
CComBSTR::ToUpper	Convertit la chaîne en majuscules.
CComBSTR::WriteToStream	Enregistre m_str dans un flux.

Opérateurs publics

Nom	Description
CComBSTR::operator BSTR	Effectue un objet d' CComBSTR à BSTR.
CComBSTR::operator !	Retourne true ou false, selon que m_strest NULL.
CComBSTR::operator ! =	Compare CComBSTR avec une chaîne.
CComBSTR::operator et	Retourne l'adresse d' m_str.
CComBSTR::operator +=	Ajoute CComBSTR à l'objet.
CComBSTR::operator <	Compare CComBSTR avec une chaîne.
CComBSTR::operator =	Assigne une valeur à m_str.
== De CComBSTR::operator	Compare CComBSTR avec une chaîne.
CComBSTR::operator >	Compare CComBSTR avec une chaîne.

Données membres publiques

Nom	Description
CComBSTR::m_str	Contient BSTR associé à l'objet d' CComBSTR .

Notes

La classe d' CComBSTR est un wrapper pour BSTRs, qui sont des chaînes longueur- préfixées.La longueur est stockée en tant qu'entier à l'emplacement mémoire précédant les données dans la chaîne.

BSTR est se terminant par null après le dernier caractère compté mais peut également contenir des caractères Null incorporés dans la chaîne.La longueur de chaîne n'est déterminée par le nombre de caractères, pas le premier caractère Null.

[!REMARQUE]

La classe d' CComBSTR fournit plusieurs membres (constructeurs, opérateurs d'assignation, et opérateurs de comparaison) qui prennent des chaînes ANSI ou Unicode comme arguments.Les versions ANSI de ces fonctions sont moins efficace que leurs équivalents Unicode parce que les chaînes Unicode temporaires sont souvent créées en interne.Pour des raisons d'efficacité, utilisez les versions Unicode lorsque cela est possible.

[!REMARQUE]

En raison de le comportement amélioré de recherche implémenté dans Visual Studio .NET, le code comme bstr = L"String2" + bstr;, qui peut avoir compilé dans les versions précédentes, doit être implémenté comme bstr = CStringW(L"String2") + bstr.

Pour une liste d'avertissements à l'aide de CComBSTR, consultez programmation avec CComBSTR.

Configuration requise

Header: atlbase.h

Voir aussi

Concepts

Macros de conversion de chaînes ATL et MFC

Autres ressources

Vue d'ensemble de la classe ATL

Partager via