16#ifndef KCODECS_EMAILADDRESS_H
17#define KCODECS_EMAILADDRESS_H
24#include <kcodecs_export.h>
348bool compareEmail(
const QString &email1,
const QString &email2,
bool matchName);
365QString
normalizedAddress(
const QString &displayName,
const QString &addrSpec,
const QString &comment = QString());
389QString
toIdn(
const QString &addrSpec);
QString fromIdn(const QString &addrSpec)
Decodes the punycode domain part of the given addr-spec if it's an IDN.
QString normalizeAddressesAndEncodeIdn(const QString &str)
Normalizes all email addresses in the given list and encodes all IDNs in punycode.
QString normalizeAddressesAndDecodeIdn(const QString &addresses)
Normalizes all email addresses in the given list and decodes all IDNs.
QString toIdn(const QString &addrSpec)
Encodes the domain part of the given addr-spec in punycode if it's an IDN.
EmailParseResult isValidAddress(const QString &aStr)
Validates an email address in the form of "Joe User" joe@example.org.
QString simpleEmailAddressErrorMsg()
Returns a i18n string to be used in msgboxes.
EmailParseResult isValidAddressList(const QString &aStr, QString &badAddr)
Validates a list of email addresses, and also allow aliases and distribution lists to be expanded bef...
QStringList splitAddressList(const QString &aStr)
Split a comma separated list of email addresses.
EmailParseResult splitAddress(const QByteArray &address, QByteArray &displayName, QByteArray &addrSpec, QByteArray &comment)
Splits the given address into display name, email address and comment.
bool isValidSimpleAddress(const QString &aStr)
Validates an email address in the form of joe@example.org.
EmailParseResult
Email validation result.
Definition kemailaddress.h:50
QString emailParseResultToString(EmailParseResult errorCode)
Translate the enum errorcodes from emailParseResult into i18n'd strings that can be used for msg boxe...
@ UnbalancedQuote
Quotes (single or double) not matched.
Definition kemailaddress.h:62
@ UnbalancedParens
Unbalanced ( )
Definition kemailaddress.h:54
@ MissingDomainPart
No domain in address.
Definition kemailaddress.h:55
@ UnexpectedComma
Comma not allowed here.
Definition kemailaddress.h:59
@ TooFewDots
Missing .
Definition kemailaddress.h:66
@ TooManyAts
More than one @ in address.
Definition kemailaddress.h:58
@ AddressOk
Email is valid.
Definition kemailaddress.h:51
@ TooFewAts
Missing @ in address.
Definition kemailaddress.h:60
@ InvalidDisplayName
An invalid displayname detected in address.
Definition kemailaddress.h:65
@ AddressEmpty
The address is empty.
Definition kemailaddress.h:52
@ UnexpectedEnd
Something is unbalanced.
Definition kemailaddress.h:53
@ DisallowedChar
An invalid character detected in address.
Definition kemailaddress.h:64
@ UnopenedAngleAddr
> with no preceding <
Definition kemailaddress.h:57
@ UnclosedAngleAddr
< with no matching >
Definition kemailaddress.h:56
@ MissingLocalPart
No address specified, only domain.
Definition kemailaddress.h:61
Definition kemailaddress.h:30
QUrl encodeMailtoUrl(const QString &mailbox)
Creates a valid mailto: URL from the given mailbox.
QString decodeMailtoUrl(const QUrl &mailtoUrl)
Extracts the mailbox out of the mailto: URL.