diff options
Diffstat (limited to 'libemailfunctions/email.h')
| -rw-r--r-- | libemailfunctions/email.h | 43 |
1 files changed, 21 insertions, 22 deletions
diff --git a/libemailfunctions/email.h b/libemailfunctions/email.h index 6c2a522d..30f4e9e5 100644 --- a/libemailfunctions/email.h +++ b/libemailfunctions/email.h @@ -1,5 +1,4 @@ -/* -*- mode: C++; c-file-style: "gnu" -*- - +/* This file is part of tdepim. Copyright (c) 2004 TDEPIM developers @@ -25,7 +24,7 @@ #include <tqstringlist.h> #include <tqcstring.h> -#include <tdepimmacros.h> +#include <kdemacros.h> /** @file */ @@ -51,7 +50,7 @@ enum EmailParseResult { AddressOk, AddressEmpty, UnexpectedEnd, // Helper functions /** Split a comma separated list of email addresses. */ -KDE_EXPORT TQStringList splitEmailAddrList(const TQString& aStr); +TDE_EXPORT TQStringList splitEmailAddrList(const TQString& aStr); /** Splits the given address into display name, email address and comment. Returns AddressOk if no error was encountered. Otherwise an appropriate @@ -72,7 +71,7 @@ KDE_EXPORT TQStringList splitEmailAddrList(const TQString& aStr); @return AddressOk if no error was encountered. Otherwise an appropriate error code is returned. */ -KDE_EXPORT EmailParseResult splitAddress( const TQCString & address, +TDE_EXPORT EmailParseResult splitAddress( const TQCString & address, TQCString & displayName, TQCString & addrSpec, TQCString & comment ); @@ -99,7 +98,7 @@ KDE_EXPORT EmailParseResult splitAddress( const TQCString & address, @return AddressOk if no error was encountered. Otherwise an appropriate error code is returned. */ -KDE_EXPORT EmailParseResult splitAddress( const TQString & address, +TDE_EXPORT EmailParseResult splitAddress( const TQString & address, TQString & displayName, TQString & addrSpec, TQString & comment ); @@ -113,7 +112,7 @@ KDE_EXPORT EmailParseResult splitAddress( const TQString & address, @return AddressOk if no error was encountered. Otherwise an appropriate error code is returned. */ -KDE_EXPORT EmailParseResult isValidEmailAddress( const TQString& aStr ); +TDE_EXPORT EmailParseResult isValidEmailAddress( const TQString& aStr ); /** Translate the enum errorcodes from emailParseResult into i18n'd strings that can be used for msg boxes. @@ -122,7 +121,7 @@ KDE_EXPORT EmailParseResult isValidEmailAddress( const TQString& aStr ); @return An i18n ready string for use in msgboxes. */ -KDE_EXPORT TQString emailParseResultToString( EmailParseResult errorCode ); +TDE_EXPORT TQString emailParseResultToString( EmailParseResult errorCode ); /** Validates an email address in the form of joe@example.org. Returns true if no error was encountered. @@ -134,7 +133,7 @@ KDE_EXPORT TQString emailParseResultToString( EmailParseResult errorCode ); example: joe.user@example.org @return true if no error was encountered. */ -KDE_EXPORT bool isValidSimpleEmailAddress( const TQString& aStr ); +TDE_EXPORT bool isValidSimpleEmailAddress( const TQString& aStr ); /** Returns a i18n string to be used in msgboxes this allows for error messages to be the same @@ -143,7 +142,7 @@ KDE_EXPORT bool isValidSimpleEmailAddress( const TQString& aStr ); @return An i18n ready string for use in msgboxes. */ -KDE_EXPORT TQString simpleEmailAddressErrorMsg(); +TDE_EXPORT TQString simpleEmailAddressErrorMsg(); /** Returns the pure email address (addr-spec in RFC2822) of the given address (mailbox in RFC2822). @@ -152,7 +151,7 @@ KDE_EXPORT TQString simpleEmailAddressErrorMsg(); @return the addr-spec of @a address, i.e. joe.user@example.org in the example */ -KDE_EXPORT TQCString getEmailAddress( const TQCString & address ); +TDE_EXPORT TQCString getEmailAddress( const TQCString & address ); /** This is an overloaded member function, provided for convenience. It behaves essentially like the above function. @@ -164,7 +163,7 @@ KDE_EXPORT TQCString getEmailAddress( const TQCString & address ); @return the addr-spec of @a address, i.e. joe.user@example.org in the example */ -KDE_EXPORT TQString getEmailAddress( const TQString & address ); +TDE_EXPORT TQString getEmailAddress( const TQString & address ); /** Returns the pure email address (addr-spec in RFC2822) of the first email address of a list of addresses. @@ -173,7 +172,7 @@ KDE_EXPORT TQString getEmailAddress( const TQString & address ); @return the addr-spec of @a addresses, i.e. joe.user@example.org in the example */ -KDE_EXPORT TQCString getFirstEmailAddress( const TQCString & addresses ); +TDE_EXPORT TQCString getFirstEmailAddress( const TQCString & addresses ); /** This is an overloaded member function, provided for convenience. It behaves essentially like the above function. @@ -185,7 +184,7 @@ KDE_EXPORT TQCString getFirstEmailAddress( const TQCString & addresses ); @return the addr-spec of @a addresses, i.e. joe.user@example.org in the example */ -KDE_EXPORT TQString getFirstEmailAddress( const TQString & addresses ); +TDE_EXPORT TQString getFirstEmailAddress( const TQString & addresses ); /** Return email address and name from string. Examples: * "Stefan Taferner <taferner@example.org>" returns "taferner@example.org" @@ -195,14 +194,14 @@ KDE_EXPORT TQString getFirstEmailAddress( const TQString & addresses ); * mail are not empty: this does NOT tell you if mail contains a * valid email address or just some rubbish. */ -KDE_EXPORT bool getNameAndMail(const TQString& aStr, TQString& name, TQString& mail); +TDE_EXPORT bool getNameAndMail(const TQString& aStr, TQString& name, TQString& mail); /** * Compare two email addresses. If matchName is false, it just checks * the email address, and returns true if this matches. If matchName * is true, both the name and the email must be the same. */ -KDE_EXPORT bool compareEmail( const TQString& email1, const TQString& email2, +TDE_EXPORT bool compareEmail( const TQString& email1, const TQString& email2, bool matchName ); /** Returns a normalized address built from the given parts. The normalized @@ -217,7 +216,7 @@ KDE_EXPORT bool compareEmail( const TQString& email1, const TQString& email2, @param comment a comment @return a normalized address built from the given parts */ -KDE_EXPORT TQString normalizedAddress( const TQString & displayName, +TDE_EXPORT TQString normalizedAddress( const TQString & displayName, const TQString & addrSpec, const TQString & comment ); @@ -226,7 +225,7 @@ KDE_EXPORT TQString normalizedAddress( const TQString & displayName, @param addrSpec a pure 7-bit email address (addr-spec in RFC2822) @return the email address with Unicode domain */ -KDE_EXPORT TQString decodeIDN( const TQString & addrSpec ); +TDE_EXPORT TQString decodeIDN( const TQString & addrSpec ); /** Encodes the domain part of the given addr-spec in punycode if it's an IDN. @@ -234,7 +233,7 @@ KDE_EXPORT TQString decodeIDN( const TQString & addrSpec ); @param addrSpec a pure email address with Unicode domain @return the email address with domain in punycode */ -KDE_EXPORT TQString encodeIDN( const TQString & addrSpec ); +TDE_EXPORT TQString encodeIDN( const TQString & addrSpec ); /** Normalizes all email addresses in the given list and decodes all IDNs. @@ -242,17 +241,17 @@ KDE_EXPORT TQString encodeIDN( const TQString & addrSpec ); @return the email addresses in normalized form with Unicode IDNs */ -KDE_EXPORT TQString normalizeAddressesAndDecodeIDNs( const TQString & addresses ); +TDE_EXPORT TQString normalizeAddressesAndDecodeIDNs( const TQString & addresses ); /** Normalizes all email addresses in the given list and encodes all IDNs in punycode. */ -KDE_EXPORT TQString normalizeAddressesAndEncodeIDNs( const TQString & str ); +TDE_EXPORT TQString normalizeAddressesAndEncodeIDNs( const TQString & str ); /** Add quote characters around the given string if it contains a * character that makes that necessary, in an email name, such as ",". */ -KDE_EXPORT TQString quoteNameIfNecessary( const TQString& str ); +TDE_EXPORT TQString quoteNameIfNecessary( const TQString& str ); } // namespace |