Класс CComBSTR

Статья
06/09/2015

Этот класс программа-оболочка для BSTR.

class CComBSTR

Члены

Открытые конструкторы

Имя	Описание
CComBSTR::CComBSTR	Конструктор.
CComBSTR::~CComBSTR	Деструктор.

Открытые методы

Имя	Описание
CComBSTR::Append	Добавляет строку в m_str.
CComBSTR::AppendBSTR	Добавляет BSTR к m_str.
CComBSTR::AppendBytes	Добавляет указанное количество байтов в m_str.
CComBSTR::ArrayToBSTR	Создает BSTR из первого символа каждого элемента в safearray и вложение его к объекту CComBSTR.
CComBSTR::AssignBSTR	Присвоит BSTR к m_str.
CComBSTR::Attach	Вложение BSTR к объекту CComBSTR.
CComBSTR::BSTRToArray	Создает нулевой- на основе одномерный массив safearray, где каждый элемент массива знаков из объекта CComBSTR.
CComBSTR::ByteLength	Возвращает длину m_str в байтах.
CComBSTR::Copy	Возвращает копию m_str.
CComBSTR::CopyTo	Возвращает копию m_str с помощью параметра [out]
CComBSTR::Detach	Наконец m_str удаляет из объекта CComBSTR.
CComBSTR::Empty	Освобождает m_str.
CComBSTR::Length	Возвращает длину m_str.
CComBSTR::LoadString	Загружает ресурс строки.
CComBSTR::ReadFromStream	Загружает объект BSTR из потока.
CComBSTR::ToLower	Выполнит преобразование строки в нижний регистр.
CComBSTR::ToUpper	Преобразует строку в прописными буквами.
CComBSTR::WriteToStream	Сохраняет m_str в поток.

Открытые операторы

Имя	Описание
CComBSTR::operator BSTR	Объект CComBSTR приводит к BSTR.
CComBSTR::operator !	Возвращает или truefalse, в зависимости от того, является ли m_strNULL.
CComBSTR::operator !=	Сравнивает CComBSTR со строкой.
CComBSTR::operator &	Возвращает адрес m_str.
CComBSTR::operator +=	Добавляет CComBSTR к объекту.
CComBSTR::operator <	Сравнивает CComBSTR со строкой.
CComBSTR::operator =	Присвоить значение m_str.
CComBSTR::operator ==	Сравнивает CComBSTR со строкой.
CComBSTR::operator >	Сравнивает CComBSTR со строкой.

Открытые члены данных

Имя	Описание
CComBSTR::m_str	Содержит BSTR, связанное с объектом CComBSTR.

Заметки

Класс CComBSTR программа-оболочка для BSTR s, обладающие префиксом длина- в строки. Длина хранится в виде целого числа в области памяти перед данным в строке.

BSTR null- завершено после последнего символа подсчитанный но может также содержать нуль-символы встроенные в строку. Длина строки определяется количеством символов, не является первым нуль-символом.

Примечание

Класс CComBSTR предоставляет несколько членов (конструкторы, операторы присваивания и операторы сравнения) тех принимает или ANSI или строки в юникоде в виде аргументов.Версии ANSI этих функций менее эффективны, чем их аналоги в юникоде, так как временные строки в юникоде часто созданы для внутреннего использования.Для повышения эффективности, используйте версии Юникода, где возможно.

Примечание

Из-за повышения расширения функциональности поиска, реализованной в Visual Studio .NET, код bstr = L"String2" + bstr;, которое может компилироваться в предыдущих выпусках должен быть реализован как вместо bstr = CStringW(L"String2") + bstr.

Список предосторежений при использовании CComBSTR см. в разделе Программирование с использованием CComBSTR.

Требования

Header: atlbase.h

См. также

Основные понятия

ATL and MFC String Conversion Macros

Другие ресурсы

ATL Class Overview

Поделиться через