office-gobmx/svl/inc/adrparse.hxx

107 lines
3.8 KiB
C++

/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef _ADRPARSE_HXX
#define _ADRPARSE_HXX
#include "svl/svldllapi.h"
#include <tools/list.hxx>
#include <tools/string.hxx>
//============================================================================
struct SvAddressEntry_Impl
{
UniString m_aAddrSpec;
UniString m_aRealName;
SvAddressEntry_Impl() {};
SvAddressEntry_Impl(UniString const & rTheAddrSpec,
UniString const & rTheRealName):
m_aAddrSpec(rTheAddrSpec), m_aRealName(rTheRealName) {}
};
//============================================================================
DECLARE_LIST(SvAddressList_Impl, SvAddressEntry_Impl *)
//============================================================================
class SVL_DLLPUBLIC SvAddressParser
{
friend class SvAddressParser_Impl;
SvAddressEntry_Impl m_aFirst;
SvAddressList_Impl m_aRest;
bool m_bHasFirst;
public:
SvAddressParser(UniString const & rInput);
~SvAddressParser();
sal_Int32 Count() const { return m_bHasFirst ? m_aRest.Count() + 1 : 0; }
inline UniString const & GetEmailAddress(sal_Int32 nIndex) const;
inline UniString const &GetRealName(sal_Int32 nIndex) const;
/** Create an RFC 822 <mailbox> (i.e., 'e-mail address').
@param rPhrase Either an empty string (the <mailbox> will have no
<phrase> an will be of the form <addr-spec>), or some text that will
become the <phrase> part of a <phrase route-addr> form <mailbox>. Non
US-ASCII characters within the text are put into a <qouted-string>
verbatim, so the result may actually not be a valid RFC 822 <mailbox>,
but a more human-readable representation.
@param rAddrSpec A valid RFC 822 <addr-spec>. (An RFC 822 <mailbox>
including a <route> cannot be created by this method.)
@param rMailbox If this method returns true, this parameter returns
the created RFC 822 <mailbox> (rather, a more human-readable
representation thereof). Otherwise, this parameter is not modified.
@return True, if rAddrSpec is a valid RFC 822 <addr-spec>.
*/
static bool createRFC822Mailbox(String const & rPhrase,
String const & rAddrSpec,
String & rMailbox);
};
inline UniString const & SvAddressParser::GetEmailAddress(sal_Int32 nIndex)
const
{
return nIndex == 0 ? m_aFirst.m_aAddrSpec :
m_aRest.GetObject(nIndex - 1)->m_aAddrSpec;
}
inline UniString const & SvAddressParser::GetRealName(sal_Int32 nIndex) const
{
return nIndex == 0 ? m_aFirst.m_aRealName :
m_aRest.GetObject(nIndex - 1)->m_aRealName;
}
#endif // _ADRPARSE_HXX