_bstr_t Class Reference

#include <comutil.h>

Classes
class	Data_t

Public Member Functions
	_bstr_t () throw ()
	_bstr_t (const _bstr_t &s) throw ()
	_bstr_t (const char *s)
	_bstr_t (const wchar_t *s)
	_bstr_t (const _variant_t &var)
	_bstr_t (BSTR bstr, bool fCopy)
	~_bstr_t () throw ()
_bstr_t &	operator= (const _bstr_t &s) throw ()
_bstr_t &	operator= (const char *s)
_bstr_t &	operator= (const wchar_t *s)
_bstr_t &	operator= (const _variant_t &var)
_bstr_t &	operator+= (const _bstr_t &s)
_bstr_t	operator+ (const _bstr_t &s) const
	operator const wchar_t * () const throw ()
	operator wchar_t * () const throw ()
	operator const char * () const
	operator char * () const
bool	operator! () const throw ()
bool	operator== (const _bstr_t &str) const throw ()
bool	operator!= (const _bstr_t &str) const throw ()
bool	operator< (const _bstr_t &str) const throw ()
bool	operator> (const _bstr_t &str) const throw ()
bool	operator<= (const _bstr_t &str) const throw ()
bool	operator>= (const _bstr_t &str) const throw ()
BSTR	copy (bool fCopy=true) const
unsigned int	length () const throw ()
void	Assign (BSTR s)
BSTR &	GetBSTR ()
BSTR *	GetAddress ()
void	Attach (BSTR s)
BSTR	Detach ()

Private Member Functions
void	_AddRef () throw ()
void	_Free () throw ()
int	_Compare (const _bstr_t &str) const throw ()

Private Attributes
Data_t *	m_Data

Friends
_bstr_t	operator+ (const char *s1, const _bstr_t &s2)
_bstr_t	operator+ (const wchar_t *s1, const _bstr_t &s2)

Constructor & Destructor Documentation

_bstr_t::_bstr_t ( ) throw ( )

inline

    : m_Data(NULL)
{
}

_bstr_t::_bstr_t ( const _bstr_t &  s ) throw ( )

inline

    : m_Data(s.m_Data)
{
    _AddRef();
}

_bstr_t::_bstr_t ( const char *  s )

inline

    : m_Data(new Data_t(s))
{
    if (m_Data == NULL) {
        _com_issue_error(E_OUTOFMEMORY);
    }
}

_bstr_t::_bstr_t ( const wchar_t *  s )

inline

    : m_Data(new Data_t(s))
{
    if (m_Data == NULL) {
        _com_issue_error(E_OUTOFMEMORY);
    }
}

_bstr_t::_bstr_t ( const _variant_t &  var )

inline

    : m_Data(NULL)
{
    if (V_VT(&var) == VT_BSTR) {
        *this = V_BSTR(&var);
        return;
    }

    _variant_t varDest;
    varDest.ChangeType(VT_BSTR, &var);

    *this = V_BSTR(&varDest);
}

_bstr_t::_bstr_t ( BSTR  bstr, bool  fCopy  )

inline

    : m_Data(new Data_t(bstr, fCopy))
{
    if (m_Data == NULL) {
        _com_issue_error(E_OUTOFMEMORY);
    }
}

_bstr_t::~_bstr_t ( ) throw ( )

inline

{
    _Free();
}

Member Function Documentation

void _bstr_t::_AddRef ( ) throw ( )

inlineprivate

{
    if (m_Data != NULL) {
        m_Data->AddRef();
    }
}

int _bstr_t::_Compare ( const _bstr_t &  str ) const throw ( )

inlineprivate

{
    if (m_Data == str.m_Data) {
        return 0;
    }

    if (m_Data == NULL) {
        if (str.length() == 0) {
            return 0;
        }
        else {
            return -1;
        }
    }

    if (str.m_Data == NULL){
        if (this->length() == 0) {
            return 0;
        }
        else {
            return 1;
        }
    }

    return m_Data->Compare(*str.m_Data);
}

void _bstr_t::_Free ( ) throw ( )

inlineprivate

{
    if (m_Data != NULL) {
        m_Data->Release();
        m_Data = NULL;
    }
}

void _bstr_t::Assign ( BSTR  s )

inline

{
    _COM_ASSERT(s == NULL || m_Data == NULL || m_Data->GetWString() != s);

    if (s == NULL || m_Data == NULL || m_Data->GetWString() != s)
    {
        _Free();

        m_Data = new Data_t(s, TRUE);
        if (m_Data == NULL) {
            _com_issue_error(E_OUTOFMEMORY);
        }
    }
}

void _bstr_t::Attach ( BSTR  s )

inline

{
    _Free();

    m_Data = new Data_t(s, FALSE);
    if (m_Data == NULL) {
        _com_issue_error(E_OUTOFMEMORY);
    }
}

BSTR _bstr_t::copy ( bool  fCopy = true ) const

inline

{
    return (m_Data != NULL) ? (fCopy ? m_Data->Copy() : m_Data->GetWString()) : NULL;
}

BSTR _bstr_t::Detach ( )

inline

{
    _COM_ASSERT(m_Data != NULL && m_Data->RefCount() == 1);

    if (m_Data != NULL && m_Data->RefCount() == 1) {
        BSTR b = m_Data->GetWString();
        m_Data->GetWString() = NULL;
        _Free();
        return b;
    }
    else {
        _com_issue_error(E_POINTER);
    }
}

BSTR * _bstr_t::GetAddress ( )

inline

{
    Attach(0);
    return &m_Data->GetWString();
}

BSTR & _bstr_t::GetBSTR ( )

inline

{
    if (m_Data == NULL) {
        m_Data = new Data_t(0, FALSE);
        if (m_Data == NULL) {
            _com_issue_error(E_OUTOFMEMORY);
        }
    }
    return m_Data->GetWString();
}

unsigned int _bstr_t::length ( ) const throw ( )

inline

{
    return (m_Data != NULL) ? m_Data->Length() : 0;
}

_bstr_t::operator char * ( ) const

inline

{
    return const_cast<char*>((m_Data != NULL) ? m_Data->GetString() : NULL);
}

_bstr_t::operator const char * ( ) const

inline

{
    return (m_Data != NULL) ? m_Data->GetString() : NULL;
}

_bstr_t::operator const wchar_t * ( ) const throw ( )

inline

{
    return (m_Data != NULL) ? m_Data->GetWString() : NULL;
}

_bstr_t::operator wchar_t * ( ) const throw ( )

inline

{
    return const_cast<wchar_t*>((m_Data != NULL) ? m_Data->GetWString() : NULL);
}

bool _bstr_t::operator! ( ) const throw ( )

inline

{
    return (m_Data != NULL) ? !m_Data->GetWString() : true;
}

bool _bstr_t::operator!= ( const _bstr_t &  str ) const throw ( )

inline

{
    return _Compare(str) != 0;
}

_bstr_t _bstr_t::operator+ ( const _bstr_t &  s ) const

inline

{
    _bstr_t b = *this;
    b += s;

    return b;
}

_bstr_t & _bstr_t::operator+= ( const _bstr_t &  s )

inline

{
    Data_t* newData = new Data_t(*this, s);
    if (newData == NULL) {
        _com_issue_error(E_OUTOFMEMORY);
    }
    else {
        _Free();
        m_Data = newData;
    }

    return *this;
}

bool _bstr_t::operator< ( const _bstr_t &  str ) const throw ( )

inline

{
    return _Compare(str) < 0;
}

bool _bstr_t::operator<= ( const _bstr_t &  str ) const throw ( )

inline

{
    return _Compare(str) <= 0;
}

_bstr_t & _bstr_t::operator= ( const _bstr_t &  s ) throw ( )

inline

{
    if (this != &s) {
        _Free();

        m_Data = s.m_Data;
        _AddRef();
    }

    return *this;
}

_bstr_t & _bstr_t::operator= ( const char *  s )

inline

{
    _COM_ASSERT(s == NULL || static_cast<const char*>(*this) != s);

    if (s == NULL || static_cast<const char*>(*this) != s)
    {
        _Free();

        m_Data = new Data_t(s);
        if (m_Data == NULL) {
            _com_issue_error(E_OUTOFMEMORY);
        }
    }

    return *this;
}

_bstr_t & _bstr_t::operator= ( const wchar_t *  s )

inline

{
    _COM_ASSERT(s == NULL || static_cast<const wchar_t*>(*this) != s);

    if (s == NULL || static_cast<const wchar_t*>(*this) != s)
    {
        _Free();

        m_Data = new Data_t(s);
        if (m_Data == NULL) {
            _com_issue_error(E_OUTOFMEMORY);
        }
    }

    return *this;
}

_bstr_t & _bstr_t::operator= ( const _variant_t &  var )

inline

{
    if (V_VT(&var) == VT_BSTR) {
        *this = V_BSTR(&var);
        return *this;
    }

    _variant_t varDest;
    varDest.ChangeType(VT_BSTR, &var);

    *this = V_BSTR(&varDest);

    return *this;
}

bool _bstr_t::operator== ( const _bstr_t &  str ) const throw ( )

inline

{
    return _Compare(str) == 0;
}

bool _bstr_t::operator> ( const _bstr_t &  str ) const throw ( )

inline

{
    return _Compare(str) > 0;
}

bool _bstr_t::operator>= ( const _bstr_t &  str ) const throw ( )

inline

{
    return _Compare(str) >= 0;
}

Friends And Related Function Documentation

_bstr_t operator+ ( const char *  s1, const _bstr_t &  s2  )

friend

{
    _bstr_t b = s1;
    b += s2;

    return b;
}

_bstr_t operator+ ( const wchar_t *  s1, const _bstr_t &  s2  )

friend

{
    _bstr_t b = s1;
    b += s2;

    return b;
}

Member Data Documentation

Data_t* _bstr_t::m_Data

private

---

The documentation for this class was generated from the following file:

• VS2017/inc/comutil.h