//%2003////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2000, 2001, 2002  BMC Software, Hewlett-Packard Development
// Company, L. P., IBM Corp., The Open Group, Tivoli Systems.
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L. P.;
// IBM Corp.; EMC Corporation, The Open Group.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
// 
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
//
//==============================================================================
//
// Author: Barbara Packard (barbara_packard@hp.com)
//
// Modified By: Jair Santos, Hewlett-Packard Company (jair.santos@hp.com)
//
//%/////////////////////////////////////////////////////////////////////////////

#ifndef __MYSTRING_H_
#define __MYSTRING_H_

#ifdef _UNICODE
#define CHAR_FUDGE 1    // one TCHAR unused is good enough
#else
#define CHAR_FUDGE 2    // two BYTES unused for case of DBC last char
#endif

// general purpose defines - may be modified later
#define BUF_MAX			256

PEGASUS_NAMESPACE_BEGIN

class PEGASUS_WMIPROVIDER_LINKAGE CMyString
{
public:

// Constructors
    CMyString( );
	CMyString(const CMyString& strSrc);
    CMyString(LPCWSTR lpsz);
    CMyString(LPCSTR lpsz);
    CMyString(const unsigned char* psz);
	CMyString(String sStr);

    BSTR Bstr();
    BOOL Compare(BSTR bStr);
    BOOL Compare(LPCTSTR szStr);

// Attributes & Operations
    // as an array of characters
    int GetLength() const{return m_nStrLen;} 
    BOOL IsEmpty() const {return m_nBufLen == 0;}
	int GetBufLength() const {return m_nBufLen;}
    void Empty(){DeallocBuffer();}		// free up the buffer
	void GetPrintableHex(int len, const unsigned char* data);	//format data buffer in hex
	int Find(TCHAR ch) const;
	int Find(TCHAR ch, int nStart) const;


    LPTSTR Copy();
	
	operator LPCTSTR() const;

    // overloaded assignment
    const CMyString& operator=(const CMyString& stringSrc);
    const CMyString& operator=(LPCWSTR lpsz);
    const CMyString& operator=(LPCSTR lpsz);
    const CMyString& operator=(const unsigned char* psz);
    const CMyString& operator=(BSTR bStr);
	const CMyString& operator=(String sStr);

	// string concatenation
    const CMyString& operator+=(const CMyString& stringSrc);
    const CMyString& operator+=(LPCTSTR lpsz);
	const CMyString& operator+=(String sStr);

// Implementation
public:
//	BOOL LoadString(UINT nID);
	int Format(LPCTSTR lpszFormat, int iSize, ...);
//	int Format(UINT nID, int iSize, ...);

	~CMyString();
	HRESULT ErrorStatus(){return m_nStatus;}

protected:
    void Init();
    BOOL AllocBuffer(int nLen);
    void AllocBeforeWrite(int nLen);
	void AssignCopy( int nLen, LPCTSTR lpsz);
    void DeallocBuffer();
	void ConcatCopy(int nLen1, LPCTSTR lpszSrc1, int nLen2, LPCTSTR lpszSrc2);
	void ConcatInPlace(int nSrcLen, LPCTSTR lpszSrc);
	int FormatV(LPCTSTR lpszFormat, int iSize, va_list argList);

    //	lengths/sizes in characters
    //  (note: an extra character is always allocated)
	//	(note: the buffer storage is always type TCHAR)
    LPTSTR          m_pszData;      // actual string (zero terminated)
    int             m_nStrLen;      // does not include terminating 0
	int				m_nBufLen;		// length of buffer in TCHARs
	HRESULT			m_nStatus;
};

PEGASUS_NAMESPACE_END

#endif // __MYSTRING_H_

